sscli new

Overview

sscli new downloads and scaffolds a production-ready project from a registered Seed & Source template. It runs linters, wires Docker, and optionally injects feature modules in a single command.

Last verified with sscli v3.2.8

Usage

sscli new --template <TEMPLATE> --name <NAME> [OPTIONS]

Options

Flag	Type	Required	Tier	Description
--template	TEXT	Yes	FREE	Template ID: rails-api | rails-fullstack | python-saas | react-client | static-landing | docs-site
--name	TEXT	Yes	FREE	Application name (used as directory name)
--target	TEXT	No	FREE	Target directory (defaults to --name)
--no-lint	BOOL	No	FREE	Disable default linters at generation time
--with-commerce	BOOL	No	ALPHA	Inject Commerce modules (Shopify/Stripe adapter pattern)
--with-payment	BOOL	No	ALPHA	Inject Stripe Payment scaffold
--with-tunnel	BOOL	No	PRO	Enable local tunneling (ngrok)
--with-landing	BOOL	No	PRO	Include static landing page (Astro) alongside the main template
--with-admin	BOOL	No	PRO	Inject NiceGUI-based admin panel
--with-sqlite	BOOL	No	FREE	Set up SQLite with Alembic (python-saas only)
--with-ingestor	BOOL	No	PRO	Inject Data Ingestor adapter pattern
--with-auth	BOOL	No	PRO	Inject authentication features (JWT / Devise)
--with-seo-analyzer	BOOL	No	FREE	Inject Lighthouse SEO analyzer (static-landing only)
--with-merchant-dashboard	BOOL	No	PRO	Include Merchant Dashboard (requires --with-commerce)
--with-sidekiq	BOOL	No	PRO	Swap solid_queue for Sidekiq (rails-api only)
--with-sandbox	BOOL	No	FREE	Inject sandbox policy with public docs read + auth-required sandbox read/write
--with-ui-lib	TEXT	No	PRO	UI library for react-client: shadcn | chakra | mui | antd | tailwind
--use-ast-injection	BOOL	No	FREE	Use AST-based feature injection (experimental)
--secrets	TEXT	No	FREE	Secrets strategy: Dotenv (default) | Doppler | Env-only
--content	TEXT	No	FREE	Path to a JSON content blueprint (static-landing)
--theme	TEXT	No	FREE	Theme for static-landing: emerald | midnight | crimson | amber
--dry-run	BOOL	No	FREE	Preview changes without writing to disk
--json	BOOL	No	FREE	JSON output (requires --dry-run)
--stats	BOOL	No	FREE	Statistics only (requires --dry-run)
--output	TEXT	No	FREE	Save dry-run output to file

Examples

Founder — Rails API backend

sscli new --template rails-api --name my-api

Backend dev — Python SaaS with commerce

sscli new --template python-saas --name payment-service --with-commerce

Frontend dev — React with auth and Shadcn UI

sscli new --template react-client --name dashboard --with-auth --with-ui-lib shadcn

Ops / full-stack — Static landing page with midnight theme

sscli new --template static-landing --name marketing-site --theme midnight

Preview before writing

sscli new --template rails-api --name my-api --dry-run --json

Docs portal with sandbox policy

sscli new --template docs-site --name seedsource-docs --with-sandbox