Recipes - seed-cli

Python Package

Standard Python package structure with src layout, tests, and modern tooling (pyproject.toml). Includes source.json — content is auto-fetched from GitHub on install. Run seed templates update python-package to refresh.

src/
├── <package_name>/
│   ├──__init__.py
│   ├──main.py
│   └──utils.py
├──tests/
│   ├──__init__.py
│   └──test_main.py
├──pyproject.toml
├──README.md
├──LICENSE
└──.gitignore

Variables

package_name - Python package name

# Add template from repo
seed templates add https://github.com/Isaac12x/seed-cli/templates/python-package/spec.tree --name python-package

# Create new project
seed templates use python-package --vars package_name=myapp

# Or use directly with create
seed create spec.tree package_name=myapp

FastAPI Application

Python API

FastAPI project with routers, models, schemas, and database setup. Includes source.json — content is auto-fetched from GitHub on install. Run seed templates update fastapi to refresh.

.
├──src/
│   ├──app/
│   │   ├──__init__.py
│   │   ├──main.py
│   │   ├──api/
│   │   │  ├──__init__.py
│   │   │  ├──routes/
│   │   │  ├──health.py
│   │   │  └──deps.py
│   │   ├──core/
│   │   │  ├──__init__.py
│   │   │  └──config.py
│   │   ├──models/
│   │   │  └──__init__.py
│   │   ├──schemas/
│   │   │  └──__init__.py
│   │   ├──services/
│   │   │  └──__init__.py
│   │   ├──db/
│   │   │  ├──__init__.py
│   │   │  └──session.py
├──tests/
│   ├──__init__.py
│   ├──conftest.py
│   └──api/
│       └──test_health.py
└──alembic/
   ├──versions/
   ├──env.py
   └──alembic.ini

# Add template from repo
seed templates add https://github.com/Isaac12x/seed-cli/templates/fastapi/spec.tree --name fastapi

# Create FastAPI project
seed templates use fastapi

Node.js TypeScript

TypeScript Node.js project with ESLint, Prettier, and testing setup. Includes source.json — content is auto-fetched from GitHub on install. Run seed templates update node-typescript to refresh.

.
├──src/
│   ├──index.ts
│   ├──config/
│   │   └──index.ts
│   ├──utils/
│   │   └──index.ts
│   └──types/
│       └──index.ts
│──tests/
│   └──index.test.ts
├──package.json
├──tsconfig.json
├──.eslintrc.json
├──.prettierrc
├──README.md
├──LICENSE
├──.gitignore
└──.nvmrc

# Add template from repo
seed templates add https://github.com/Isaac12x/seed-cli/templates/node-typescript/spec.tree --name node-typescript

# Create TypeScript project
seed templates use node-typescript

Ralph

Scripts PRD

Ralph script structure for PRD-driven development workflows.

./
├── scripts/
    ├── ralph/
        ├── ralph-once.sh
        ├── ralph.sh
        ├── progress.txt
        ├── prd.json
        └── PRD.md
    ├──...
├──...

# Add template from repo
seed templates add https://github.com/Isaac12x/seed-cli/templates/ralph/spec.tree --name ralph

# Add ralph scripts to your project
seed templates use ralph

Ready-to-use Templates

Python Package

Variables

FastAPI Application

Node.js TypeScript

Ralph