Bring Your Own Backend
Your Postgres. Schema-aware AI UI.
Shipboard connects to Neon or Supabase for a single read-only introspection. The schema map (table names, columns, and foreign keys) is stored in this browser only — localStorage key Shipboard.studio.settings.v1. It is not uploaded to Shipboard servers. The connection string is used for a single read-only introspect request and is not persisted. Database rows are never copied.
How BYOB works
- 1Settings → Database — paste a postgresql:// connection string
- 2Connect & map schema (information_schema only, read-only)
- 3Schema map stays in this browser (localStorage) — not on our servers
- 4Preview mocks @/app/actions so the iframe stays safe
- 5Ship / eject emits Drizzle + Server Actions for your tables
- 6After clone: set DATABASE_URL in .env.local and run npm run dev
Safety guarantees
- No auto-migrations into your database
- No platform tables injected into your BYOB DB
- Connection string used for one introspect request — not stored. Schema map lives in browser localStorage, not on the server
- You own the data plane after eject
Golden path: connect BYOB, then run Admin Users so the table uses real column names from your schema.