BoilerWorks

boilerworks / docs / index.md

Source Blame History 115 lines

6f83112…	anonymous	1	# Boilerworks
6f83112…	anonymous	2
6f83112…	anonymous	3	Stop vibe-coding scaffolding. Pick a template. Ship.
6f83112…	anonymous	4
6f83112…	anonymous	5	Boilerworks is a catalogue of opinionated, production-ready full-stack templates. One command gets you from zero to a running app with auth, database, background jobs, Docker, and CI — all pre-wired.
6f83112…	anonymous	6
6f83112…	anonymous	7	---
6f83112…	anonymous	8
6f83112…	anonymous	9	## Install
6f83112…	anonymous	10
6f83112…	anonymous	11	```bash
6f83112…	anonymous	12	pip install boilerworks
6f83112…	anonymous	13	```
6f83112…	anonymous	14
6f83112…	anonymous	15	## Quick Start
6f83112…	anonymous	16
6f83112…	anonymous	17	```bash
6f83112…	anonymous	18	# See all templates
6f83112…	anonymous	19	boilerworks list
6f83112…	anonymous	20
6f83112…	anonymous	21	# Run the setup wizard
6f83112…	anonymous	22	boilerworks setup
6f83112…	anonymous	23
6f83112…	anonymous	24	# Generate your project
6f83112…	anonymous	25	boilerworks init
6f83112…	anonymous	26	```
6f83112…	anonymous	27
6f83112…	anonymous	28	That's it. `boilerworks init` clones the template, renames everything from `boilerworks` to your project name, and hands you a working repo with a clean git history.
6f83112…	anonymous	29
6f83112…	anonymous	30	---
6f83112…	anonymous	31
6f83112…	anonymous	32	## The Catalogue
6f83112…	anonymous	33
6f83112…	anonymous	34	26 templates across 10 stacks. Three sizes.
6f83112…	anonymous	35
6f83112…	anonymous	36	\| Size \| When to use \|
6f83112…	anonymous	37	\|------\|-------------\|
6f83112…	anonymous	38	\| Full \| Apps with users — login, permissions, org management \|
6f83112…	anonymous	39	\| Micro \| API-key services, microservices, workers \|
6f83112…	anonymous	40	\| Edge \| Cloudflare Workers / Pages, globally distributed \|
6f83112…	anonymous	41
6f83112…	anonymous	42	=== "Full"
6f83112…	anonymous	43
6f83112…	anonymous	44	\| Template \| Stack \|
6f83112…	anonymous	45	\|----------\|-------\|
6f83112…	anonymous	46	\| `django-nextjs` \| Django 5 + Next.js 16 (GraphQL) \|
6f83112…	anonymous	47	\| `rails-nextjs` \| Rails 8 + Next.js 16 (GraphQL) \|
6f83112…	anonymous	48	\| `rails-hotwire` \| Rails 8 + Hotwire + Tailwind \|
6f83112…	anonymous	49	\| `nestjs-nextjs` \| NestJS + Next.js 16 (GraphQL) \|
6f83112…	anonymous	50	\| `laravel-vue` \| Laravel 12 + Vue 3 (Inertia) \|
6f83112…	anonymous	51	\| `spring-angular` \| Spring Boot + Angular 19 \|
6f83112…	anonymous	52	\| `go-nextjs` \| Go + Next.js 16 (GraphQL) \|
6f83112…	anonymous	53	\| `remix-full` \| Remix (full-stack) \|
6f83112…	anonymous	54	\| `sveltekit-full` \| SvelteKit (full-stack) \|
6f83112…	anonymous	55	\| `phoenix-liveview` \| Phoenix + LiveView \|
6f83112…	anonymous	56
6f83112…	anonymous	57	=== "Micro"
6f83112…	anonymous	58
6f83112…	anonymous	59	\| Template \| Stack \|
6f83112…	anonymous	60	\|----------\|-------\|
6f83112…	anonymous	61	\| `django-micro` \| Django 5 REST API \|
6f83112…	anonymous	62	\| `fastapi-micro` \| FastAPI + async \|
6f83112…	anonymous	63	\| `nestjs-micro` \| NestJS REST API \|
6f83112…	anonymous	64	\| `rails-micro` \| Rails 8 API mode \|
6f83112…	anonymous	65	\| `laravel-micro` \| Laravel 12 API \|
6f83112…	anonymous	66	\| `spring-micro` \| Spring Boot REST \|
6f83112…	anonymous	67	\| `go-micro` \| Go REST API \|
6f83112…	anonymous	68	\| `express-micro` \| Express + TypeScript \|
6f83112…	anonymous	69	\| `phoenix-micro` \| Phoenix API \|
6f83112…	anonymous	70	\| `rust-micro` \| Axum REST API \|
6f83112…	anonymous	71
6f83112…	anonymous	72	=== "Edge"
6f83112…	anonymous	73
6f83112…	anonymous	74	\| Template \| Stack \|
6f83112…	anonymous	75	\|----------\|-------\|
6f83112…	anonymous	76	\| `sveltekit-edge` \| SvelteKit on Cloudflare Pages \|
6f83112…	anonymous	77	\| `remix-edge` \| Remix on Cloudflare Pages \|
6f83112…	anonymous	78	\| `nextjs-edge` \| Next.js on Cloudflare Pages \|
6f83112…	anonymous	79	\| `astro-edge` \| Astro on Cloudflare Pages \|
6f83112…	anonymous	80	\| `hono-edge` \| Hono on Cloudflare Workers \|
6f83112…	anonymous	81	\| `worker-edge` \| Cloudflare Worker (bare) \|
6f83112…	anonymous	82
6f83112…	anonymous	83	---
6f83112…	anonymous	84
6f83112…	anonymous	85	## How It Works
6f83112…	anonymous	86
6f83112…	anonymous	87	```
6f83112…	anonymous	88	boilerworks setup → answer 13 questions → writes boilerworks.yaml
6f83112…	anonymous	89	boilerworks init → reads boilerworks.yaml → clones + renames + git init
6f83112…	anonymous	90	```
6f83112…	anonymous	91
6f83112…	anonymous	92	The renderer does case-variant string replacement across every text file:
6f83112…	anonymous	93
6f83112…	anonymous	94	- `boilerworks` → `myproject`
6f83112…	anonymous	95	- `Boilerworks` → `Myproject`
6f83112…	anonymous	96	- `BOILERWORKS` → `MYPROJECT`
6f83112…	anonymous	97
6f83112…	anonymous	98	No Jinja2, no magic. Templates are real repos that boot as-is.
6f83112…	anonymous	99
6f83112…	anonymous	100	---
6f83112…	anonymous	101
6f83112…	anonymous	102	## Infrastructure (optional)
6f83112…	anonymous	103
6f83112…	anonymous	104	If you select a cloud provider during setup, `boilerworks init` also clones [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) — a Terraform repo with full AWS infrastructure (ECS Fargate, RDS, Redis, ALB, Route53, ACM) and GCP/Azure stubs.
6f83112…	anonymous	105
6f83112…	anonymous	106	Two topology options:
6f83112…	anonymous	107
6f83112…	anonymous	108	- Standard — app and ops land in sibling directories
6f83112…	anonymous	109	- Omni — ops lives inside the app repo as `ops/`
6f83112…	anonymous	110
6f83112…	anonymous	111	---
6f83112…	anonymous	112
6f83112…	anonymous	113	## License
6f83112…	anonymous	114
6f83112…	anonymous	115	MIT — Copyright © 2026 CONFLICT LLC

BoilerWorks

Keyboard Shortcuts