Seed & Source CLI (sscli)

The unified scaffold tool for the Seed & Source template library. Pick a base, bolt on features, ship faster.

🎯 What is sscli?

sscli is a code-generation CLI that pulls production-ready project templates and injects optional premium modules into them. Every template is a complete, opinionated starting point — not a toy boilerplate.

• ✅ Production-ready bases — Rails API, Python SaaS, React, Astro, mobile, and more
• ✅ Optional feature injection — Commerce, Auth, Admin, Tunnels, and others added at scaffold time
• ✅ Clean architecture — Hexagonal (Python), standard Rails conventions, functional React
• ✅ Docker-first — Every template ships with a multi-stage production Dockerfile

📦 Install

# Recommended
pipx install sscli

# Or via pip
pip install sscli

# Verify
sscli --version

🚀 Quick Start

# Interactive mode — guided setup with template picker
sscli interactive

# Or go direct
sscli new --template rails-api --name my-api

New to Seed & Source? Start here: ../../docs/public/GETTING_STARTED.md

✅ Quick Validation

Before committing changes, run the test suite:

pytest

Expected output: Exit code 0 + coverage ≥ 90%

Results:

• Coverage report: coverage_report/index.html
• Coverage XML: coverage.xml

For details, see Quick Start Validation Guide.

🗂️ Templates

Run sscli explore to browse all templates interactively in your terminal.

🛤️ Rails API  ·  rails-api  ·  FREE

A production-grade JSON API built on Rails 8 — opinionated, deployable on day one.

app/
├── controllers/api/v1/   # Versioned JSON endpoints
├── models/               # ActiveRecord (PostgreSQL)
├── services/             # Business logic layer
└── serializers/          # JSON serialization

What's in the base:

• Rails 8.0 + PostgreSQL + Devise (authentication)
• RSpec test suite + FactoryBot
• HMAC webhook validation scaffolding
• Docker + .env secrets management
• RuboCop enforced

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

🧱 Rails API Hex  ·  rails-api-hex  ·  FREE

A production-grade JSON API built on Rails 8 with an explicit hexagonal architecture.

app/
├── domain/               # Pure domain entities and ports
├── use_cases/            # Application business flows
├── infrastructure/       # Repositories, persistence, external adapters
├── controllers/api/v1/   # HTTP entrypoints
└── serializers/          # JSON serialization

What's in the base:

• Rails 8.0 + PostgreSQL + Devise (authentication)
• Hexagonal layering via routes -> use_cases -> entities
• RSpec test suite + FactoryBot
• Docker + .env secrets management
• RuboCop enforced

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

sscli new \
  --template rails-api \
  --name commerce-backend \
  --with-commerce

Request Flow:
Provider Webhook → HMAC Validator → Adapter (fake/stripe/mercado_pago)
  → Provisioning::IssueResource → CommercialAgreement + SecurityToken

🏗️ Rails Fullstack  ·  rails-fullstack  ·  PRO

A Hotwire / Turbo fullstack Rails 8 application — session auth, server-rendered HTML, and the full hexagonal domain layer shared with rails-api-hex via rails-hexagonal-base.

app/
├── domain/         # Pure Ruby ports + entities (shared with rails-api-hex)
├── use_cases/      # Business logic — no HTTP dependency
├── infrastructure/ # AR repositories (shared with rails-api-hex)
├── controllers/    # ActionController::Base, flash & redirects
├── views/          # ERB layouts + Turbo Stream partials
└── components/     # ViewComponent

What's in the base:

• Rails 8 + Hotwire (Turbo + Stimulus) + Tailwind CSS
• Devise session auth (no JWT — full cookie/CSRF stack)
• ViewComponent + Capybara system specs
• Hexagonal domain layer from rails-hexagonal-base (zero drift guarantee)
• RuboCop + Brakeman gate via bin/ci
• Docker + .env secrets management

sscli new --template rails-fullstack --name my-app

🐍 Python SaaS  ·  python-saas  ·  ALPHA

A Hexagonal Architecture Python service — ports and adapters enforced from project root.

src/
├── core/
│   ├── entities/          # Pure domain models (no I/O)
│   └── use_cases/         # Business logic (depends only on entities)
└── infrastructure/
    ├── adapters/          # DB, HTTP, external services
    └── ui/                # FastAPI / Django routes

What's in the base:

• Python 3.11+ with FastAPI or Django
• SQLAlchemy ORM + Pydantic v2 validation
• ruff + mypy strict mode enforced
• Multi-tier secrets management (Dotenv, Doppler, Env-only)
• pytest with coverage gate (target 95% on codemods)

sscli new --template python-saas --name my-service

sscli new \
  --template python-saas \
  --name data-service \
  --with-sqlite

🌐 Static Landing  ·  static-landing  ·  ALPHA

An Astro-powered static site built for SaaS marketing pages — multi-theme, blueprint-driven.

src/
├── components/   # Astro/React island components
├── pages/        # File-based routing
└── content/      # Markdown + JSON content layer
blueprint.json    # Content & theme configuration file

What's in the base:

• Astro 5.0 + Tailwind CSS
• Multi-theme system (Emerging Emerald, Midnight Azure, Crimson Bloom, Vibrant Amber)
• blueprint.json manifest for content/theme customization
• Static build → Nginx Docker image
• Playwright smoke tests

sscli new --template static-landing --name my-landing

# With custom content & theme
sscli new \
  --template static-landing \
  --name my-landing \
  --content ./my-blueprint.json \
  --theme midnight

⚛️ React Client  ·  react-client  ·  ALPHA

A React 18 + Vite frontend with the full modern stack, ready to connect to any of the backend templates.

src/
├── components/   # Functional components only
├── hooks/        # Custom hooks for all business logic
├── pages/        # Route-level components
└── api/          # React Query client bindings

What's in the base:

• React 18 + Vite (JSX-first template; TypeScript can be added post-generate)
• React Query for server state
• Tailwind CSS
• ESLint + Prettier strict mode
• Jest + Playwright

sscli new --template react-client --name my-frontend

sscli new \
  --template react-client \
  --name merchant-ui \
  --with-commerce

📊 Data Pipeline  ·  data-pipeline  ·  ALPHA

A dbt + Python data stack for SaaS analytics and data transformation pipelines.

sscli new --template data-pipeline --name my-pipeline

📱 Mobile  ·  ALPHA

🏗️ Infrastructure  ·  ALPHA

🔧 CLI Reference

Feature Flags for sscli new

🔄 Updates

pipx upgrade sscli
# or
pip install --upgrade sscli

❓ Troubleshooting

sscli --version

# If missing, reinstall via pipx
pipx uninstall sscli
pipx install sscli

# Check template integrity first
sscli verify --template rails-api

# Preview without writing files
sscli new --template rails-api --name test --dry-run

📞 Support

• Docs: docs.seedsource.dev
• GitHub: seed-source/stack-cli
• Email: support@seedsource.dev

📄 License

MIT