boilerworks 0.3.0

Production-ready project templates — assembled in seconds.

Boilerworks

Production-ready project templates — assembled in seconds.

Boilerworks is a CLI that clones and configures any of 27 opinionated, best-of-breed project templates. Stop re-solving auth, permissions, Docker, CI, and admin panels from scratch. Pick a stack, run boilerworks init, and get straight to your business logic.

pip install boilerworks
boilerworks setup    # interactive wizard → writes boilerworks.yaml
boilerworks init     # clone + configure the template
cd my-project
docker compose up -d # full stack running in seconds

---

Installation

pip install boilerworks
# or with uv:
uv tool install boilerworks

Requires Python 3.12+.

---

Quick Start

1. Run the setup wizard

boilerworks setup

Answer 13 questions about your project (name, template, cloud, compliance, etc.) and a boilerworks.yaml manifest is written to the current directory.

2. Generate the project

boilerworks init

Boilerworks clones the selected template, replaces all boilerworks references with your project name, and runs git init to give you a clean starting commit.

3. Start developing

cd my-project
docker compose up -d
# Visit http://localhost:3000

One command. Full stack. No manual setup.

---

Template Catalogue

27 templates across three sizes:

Size	Description	Auth	Deploy Target
Full	Apps with users	Session auth, permissions, org management	VPS, containers, Kubernetes
Micro	API services	API-key auth	VPS, containers
Edge	Serverless apps	Flexible	Cloudflare Workers / Pages

Full Templates (16)

Name	Backend	Frontend
django-nextjs	Django 5	Next.js 16
django-nextjs-copilotkit	Django 6	Next.js 16 + CopilotKit
nestjs-nextjs	NestJS 11	Next.js 16
rails-hotwire	Rails 8	Hotwire + Tailwind
rails-nextjs	Rails 8	Next.js 16
spring-angular	Spring Boot 3	Angular 19
go-nextjs	Go + Chi	Next.js 16
phoenix-liveview	Phoenix 1.7	LiveView
laravel-vue	Laravel 12	Inertia + Vue 3
django-htmx	Django 5	HTMX + Alpine.js
fastapi-nextjs	FastAPI	Next.js 16
spring-nextjs	Spring Boot 3	Next.js 16
laravel-livewire	Laravel 12	Livewire 3
go-htmx	Go + Chi	HTMX + Templ
fastapi-htmx	FastAPI	HTMX + Alpine.js
saleor-nextjs	Saleor (Django)	Next.js 16

Micro Templates (6)

Name	Backend
django-micro	Django 5 (DRF/Ninja)
fastapi-micro	FastAPI
nestjs-micro	NestJS 11
go-micro	Go + Chi
rust-micro	Axum (Rust)
cherrypy-micro	CherryPy

Edge Templates (5)

Name	Framework
sveltekit-full	SvelteKit
remix-full	Remix
hono-micro	Hono (Cloudflare Workers)
nuxt-full	Nuxt 4
astro-site	Astro

---

Commands

boilerworks --help              # show all commands
boilerworks list                # show all 27 templates
boilerworks list --size micro   # filter by size
boilerworks list --language python  # filter by language
boilerworks list --json         # machine-readable output (for scripts/agents)
boilerworks info django-nextjs  # full details for one template + its GitHub URL
boilerworks setup               # interactive wizard
boilerworks init                # generate project from boilerworks.yaml
boilerworks init --dry-run      # preview what would happen
boilerworks init --manifest ./path/to/boilerworks.yaml
boilerworks init --output /path/to/output

---

boilerworks.yaml

The manifest file describes your project. Generated by boilerworks setup, editable by hand.

project: my-app
family: django-nextjs
size: full
topology: standard
cloud: aws
ops: true
region: us-east-1
domain: myapp.com
mobile: false
web_presence: false
compliance:
  - soc2
services:
  email: ses
  cache: redis
data:
  database: postgres
  migrations: true
  seed_data: true
testing:
  e2e: playwright
  unit: true
  integration: true

See boilerworks.yaml.example for a fully annotated version.

---

MCP Server

Boilerworks ships an MCP server so AI agents can browse the catalogue, build manifests, and scaffold projects as tools. The mcp dependency is an optional extra:

pip install 'boilerworks[mcp]'
boilerworks-mcp                 # stdio MCP server

Register it with Claude Code:

claude mcp add boilerworks -- boilerworks-mcp

Tools exposed: list_templates, get_template, search_templates, create_manifest, validate_manifest, dry_run, init_project.

---

Claude Code Skill

skill/skill.md is a Claude Code skill that teaches an agent the template catalogue, the boilerworks.yaml schema, and the conventions inside generated projects. Its catalogue tables are generated from boilerworks/data/templates.yaml by scripts/gen_skill_catalogue.py, and a test keeps them in sync.

---

What Every Template Includes

Every Boilerworks Full template ships with:

• Auth — session-based (httpOnly cookies), bcrypt passwords
• Permissions — group-based, per-operation, checked at every endpoint
• Background jobs — Redis-backed queue, retries, dead-letter handling
• Email — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally)
• Admin — authenticated management interface with CRUD for all models
• Docker Compose — one command to boot the full stack
• CI/CD — GitHub Actions: lint, test, build, audit
• AI agent shims — CLAUDE.md, AGENTS.md, bootstrap.md

---

Infrastructure

Pair any template with boilerworks-opscode for production Terraform:

• AWS — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager
• GCP / Azure — structured stubs ready for expansion

Select a cloud in boilerworks setup and boilerworks init will clone and configure the ops repo alongside your app.

---

Contributing

See CONTRIBUTING.md for the development process.

Issues and PRs welcome at github.com/ConflictHQ/boilerworks.

---

Links

• Documentation: boilerworks.dev
• Product: boilerworks.ai
• Templates: github.com/ConflictHQ

---

Boilerworks is a CONFLICT brand. CONFLICT is a registered trademark of CONFLICT LLC.