Packages

Shared workspace packages live under packages/. They are linked into apps via the workspace alias ('ui', 'common', 'ai-commands', etc.) — never by relative path.

Package	Purpose	Page
ui	Shared React component library (Radix + shadcn).	ui
ui-patterns	Higher-level patterns built on ui.	ui-patterns
common	Auth, telemetry, feature flags, helpers.	common
ai-commands	OpenAI / Bedrock prompts and streaming commands.	ai-commands
pg-meta	SQL generators for Postgres schema CRUD.	pg-meta
api-types	Generated TypeScript types for the Supabase platform / management API.	api-types
marketing	Building blocks for apps/www (/go/*, CRM client, section schemas).	marketing
shared-data	Static data shared between apps.	shared-data
icons	Icon registry.	icons
config	Shared runtime configuration.	config
tsconfig	Shared TypeScript configs.	config
eslint-config-supabase	Shared ESLint config.	config
dev-tools, build-icons, generator, pg-meta-cli	Internal tooling.	tooling-packages

The full list (ls packages/):

ai-commands  api-types  build-icons  common  config  dev-tools
eslint-config-supabase  generator  icons  marketing  pg-meta
shared-data  tsconfig  ui  ui-patterns

Naming and conventions

• All packages use kebab-case directory names.
• Packages are private (not published to npm) unless explicitly intended to be public.
• Each package owns its own tsconfig.json (extending packages/tsconfig), vitest.config.ts if it has tests, and a minimal package.json.
• Component packages re-export from a top-level index.ts / index.tsx so consumers can import { Button } from 'ui'.

Cross-package imports

Studio is the largest consumer:

graph LR
    Studio[apps/studio] --> UI[ui]
    Studio --> UIP[ui-patterns]
    Studio --> Common[common]
    Studio --> ApiTypes[api-types]
    Studio --> AiCommands[ai-commands]
    Studio --> PgMeta[pg-meta]
    Studio --> Icons[icons]
    Studio --> Config[config]
    Studio --> SharedData[shared-data]

    UIP --> UI
    Common --> Config

The docs, www, design-system, ui-library, and learn apps all consume ui, ui-patterns, icons, and shared-data similarly. marketing is consumed mostly by www.