@sveltebuilder/cli

Ongoing project management CLI for SvelteBuilder projects. create-sveltebuilder depends on this package internally — sync logic is never duplicated between initial scaffolding and later module additions.

Install

Usually you don't install this directly — npm create sveltebuilder@latest adds it to your project automatically. To use it standalone:

npm install -D @sveltebuilder/cli

Usage

sveltebuilder sync:supabase   # generate Supabase migrations from Drizzle schemas
sveltebuilder sync:drizzle    # assemble Drizzle schema for the Native template (not yet implemented)
sveltebuilder sync            # deprecated alias for sync:supabase

sveltebuilder sync:supabase:

1. Discovers every installed module's schema manifest under .sveltebuilder/registry/*.json.
2. Topologically sorts them by each manifest's after dependencies (hermes schema first, then domain modules).
3. Writes a barrel file (.sveltebuilder/schema.ts) and a generated drizzle.config.ts.
4. Runs drizzle-kit generate to produce Supabase migrations, appends each module's supplemental SQL (RLS policies, triggers, cross-module FK constraints), and rewrites supabase/config.toml's migrations.schema_paths.
5. Assembles supabase/seed.sql from the base hermes seed data plus each module's seed SQL.

Programmatic API

import { syncSupabase, syncDrizzle } from '@sveltebuilder/cli/api';

create-sveltebuilder calls syncSupabase directly as the final step of scaffolding a new project.

Part of the SvelteBuilder ecosystem

See the SvelteBuilder README for how schema ordering, modules, and the scaffold templates fit together.