PreviousNext

CLI

Commands to bootstrap and reshape projects with feature-level control.

What It Does

@creatorem/cli scaffolds and refactors monorepos using app + feature selection. It can also generate SQL artifacts from .creatorem/setup.json inputs.

When To Use

  • Starting a new customer project.
  • Removing unused features from an existing repo.
  • Generating SQL schemas/migrations after setup changes.

Prerequisites

  • git available in PATH.
  • pnpm workspace environment.
  • Run from monorepo root for generate-sql commands.

How To Use

Core commands

pnpm dlx @creatorem/cli create
creatorem create-dashboard my-dashboard --features ai,keybindings
creatorem create-mobile my-mobile --features organization,onboarding
creatorem generate-sql
creatorem generate-schemas
creatorem generate-migration

Important options

  • --features: comma-separated feature keys to keep.
  • --edit: mutate current app in place.
  • --repo-scope: also remove repo-level assets/dependencies for deselected features.
  • --oss: force OSS template source.

Selectable apps

AppDescription
DashboardMain SaaS dashboard (Next.js)
MarketingLanding / marketing website (Next.js)
MobileReact Native app (Expo)
APIStandalone API server
ExamplesOptional real-case example apps from examples/* to bootstrap from concrete implementations

Selectable features

Features are selected per app. Each one toggles UI components, database schemas, and kit packages.

Dashboard

KeyWhat it adds
analyticsGoogle Analytics and Umami support
monitoringSentry integration
aiAI chat UI, tools, AI wallet and usage tracking
organizationTeams, roles, member management, <OrganizationSwitcher />
notificationNotification UI and database logic
billingStripe and Lemon Squeezy, subscriptions, one-time payments, credit wallet
content-typePremade data-display components, search helpers, edit forms
keybindingsKeyboard shortcut settings UI and React hooks
onboardingPost-signup information collection
email-templatesReact Email templates for auth and transactional emails
emailerEmail sending via Nodemailer, Postmark, Resend, or Sendgrid

Mobile

KeyWhat it adds
organizationTeams, roles, member management (React Native)
notificationNotification UI and database logic (React Native)
onboardingPost-signup information collection

Selectable examples

If the source repository contains an examples/ directory, the wizard can include one or more examples in the generated project.

SQL generation behavior

  • generate-schemas: creates supabase/app-schemas/*.sql.
  • generate-migration: merges supabase/schemas + supabase/app-schemas into supabase/migrations/<timestamp>_generated_from_schemas.sql.
  • generate-sql defaults to migration mode.

MCP Context

capability: project_generation_and_refactor entrypoints: - cli/src/cli.tsx - cli/src/commands/create*.tsx - cli/src/commands/generate-*.mjs inputs: - app_selection - feature_selection - setup_reference outputs: - generated_or_trimmed_monorepo - generated_sql_artifacts constraints: - feature keys must match command-specific feature registries - SQL generation expects supabase directory structure side_effects: - creates/deletes files - updates workspace deps and manifests

Agent Recipe

  1. For new projects, run create and choose apps/features interactively.
  2. For existing repos, use create-dashboard --edit or create-mobile --edit with explicit --features.
  3. After schema/setup edits, run creatorem generate-sql from root.

Troubleshooting

  • If generate-sql cannot find setup input, pass explicit path: creatorem generate-schemas apps/<app>/.creatorem/setup.json.
  • If repo cleanup is incomplete, rerun with --repo-scope.

How is this guide?

Last updated on 3/23/2026