Steven Eubank
62c5a224d0
- clean up a lot of slop comments - condense files for the actual studio - make the extension feel like a product - log and fixings to be able to make it a real extension
Supabase Dev Tools
Supabase developer tooling (more to come). Today: run Studio locally (full HMR) against a hosted Supabase backend, no local Docker stack — the same code the hosted dashboard runs, pointed at a hosted API through a same-origin dev proxy. For Supabase devs and OSS contributors.
Run
| command | mode |
|---|---|
pnpm dev:studio |
local (default fake project) |
pnpm dev:studio:remote |
hosted production |
pnpm dev:studio:remote:staging |
hosted staging |
Then authenticate and open a real project. Add --print to dry-run.
How it works
flowchart LR
B["Browser localhost:8082"]
DEV["Next dev server (proxy)"]
API["hosted API /platform,/v1"]
GT["hosted GoTrue"]
PROJ["ref.supabase.co"]
B -->|UI + HMR| DEV
B -->|/platform, /v1, /auth| DEV
DEV ==>|server-side, bearer token| API
DEV ==>|server-side| GT
B -->|apikey, direct| PROJ
The browser only makes same-origin calls; the dev server forwards them to the
hosted backend server-side, so there's no CORS. Auth is a bearer token in
localStorage (not a cookie) — nothing to cookie-sync.
Auth
Hosted OAuth can't redirect to localhost, so copy your existing session instead of signing in — that's what this extension does:
chrome://extensions→ Developer mode → Load unpacked → this folder.- Sign in on
supabase.com(orsupabase.green); open local Studio. - Click the extension → Sync. Green dot = connected.
It copies a live token — dev-only, load unpacked in your own browser.
Why
Working a bug fix or feature? Verify it against the real backend — same code, same API — so "works locally" actually means "works in prod." Finally retire "works on my machine." 🫡
TODO
- Screenshot of the popup:
- Chrome Web Store (unlisted — see
CHROMEWEBSTORE.md) - Persistent REMOTE/PROD badge in Studio (safety indicator)
- Fill staging hosts in
scripts/dev-remote.mjs - Self-hosted support (untested — self-hosted stacks don't serve
/platform) - Wire the Vite/TanStack proxy path