BoilerWorks

docs: update README — all 26 templates done, correct versions, ops section

anonymous 2026-03-30 03:54 trunk
Commit c5c508547343a65d1de6972492df18c131ca6240e8429942bf0dfa861332a3c4
1 file changed +48 -40
+48 -40
--- README.md
+++ README.md
@@ -2,11 +2,11 @@
22
33
**Production-ready project templates — assembled in seconds.**
44
55
Boilerworks is a CLI that clones and configures any of 26 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.
66
7
-```
7
+```bash
88
pip install boilerworks
99
boilerworks setup # interactive wizard → writes boilerworks.yaml
1010
boilerworks init # clone + configure the template
1111
cd my-project
1212
docker compose up -d # full stack running in seconds
@@ -66,48 +66,48 @@
6666
| **Micro** | API services | API-key auth | VPS, containers |
6767
| **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages |
6868
6969
### Full Templates (15)
7070
71
-| Name | Backend | Frontend | Status |
72
-|------|---------|----------|--------|
73
-| django-nextjs | Django 5 | Next.js 16 | ✅ Done |
74
-| nestjs-nextjs | NestJS 11 | Next.js 16 | ✅ Done |
75
-| django-htmx | Django 5 | HTMX + Alpine.js | 🔨 Building |
76
-| saleor-nextjs | Saleor (Django) | Next.js 16 | 🔨 Building |
77
-| rails-hotwire | Rails 8 | Hotwire | 🔨 Building |
78
-| laravel-vue | Laravel 11 | Inertia + Vue 3 | 🔨 Building |
79
-| fastapi-nextjs | FastAPI | Next.js 16 | 🔨 Building |
80
-| fastapi-htmx | FastAPI | HTMX + Alpine.js | 📋 Planned |
81
-| spring-angular | Spring Boot 3 | Angular 19 | 📋 Planned |
82
-| go-htmx | Go + Chi/Echo | HTMX + Templ | 📋 Planned |
83
-| rails-nextjs | Rails 8 | Next.js 16 | 📋 Planned |
84
-| phoenix-liveview | Phoenix 1.7 | LiveView | 📋 Planned |
85
-| spring-nextjs | Spring Boot 3 | Next.js 16 | 📋 Planned |
86
-| go-nextjs | Go + Chi/Echo | Next.js 16 | 📋 Planned |
87
-| laravel-livewire | Laravel 11 | Livewire 3 | 📋 Planned |
71
+| Name | Backend | Frontend |
72
+|------|---------|----------|
73
+| [django-nextjs](https://github.com/ConflictHQ/boilerworks-django-nextjs) | Django 5 | Next.js 16 |
74
+| [nestjs-nextjs](https://github.com/ConflictHQ/boilerworks-nestjs-nextjs) | NestJS 11 | Next.js 16 |
75
+| [rails-hotwire](https://github.com/ConflictHQ/boilerworks-rails-hotwire) | Rails 8 | Hotwire + Tailwind |
76
+| [rails-nextjs](https://github.com/ConflictHQ/boilerworks-rails-nextjs) | Rails 8 | Next.js 16 |
77
+| [spring-angular](https://github.com/ConflictHQ/boilerworks-spring-angular) | Spring Boot 3 | Angular 19 |
78
+| [go-nextjs](https://github.com/ConflictHQ/boilerworks-go-nextjs) | Go + Chi | Next.js 16 |
79
+| [phoenix-liveview](https://github.com/ConflictHQ/boilerworks-phoenix-liveview) | Phoenix 1.7 | LiveView |
80
+| [laravel-vue](https://github.com/ConflictHQ/boilerworks-laravel-vue) | Laravel 12 | Inertia + Vue 3 |
81
+| [django-htmx](https://github.com/ConflictHQ/boilerworks-django-htmx) | Django 5 | HTMX + Alpine.js |
82
+| [fastapi-nextjs](https://github.com/ConflictHQ/boilerworks-fastapi-nextjs) | FastAPI | Next.js 16 |
83
+| [spring-nextjs](https://github.com/ConflictHQ/boilerworks-spring-nextjs) | Spring Boot 3 | Next.js 16 |
84
+| [laravel-livewire](https://github.com/ConflictHQ/boilerworks-laravel-livewire) | Laravel 12 | Livewire 3 |
85
+| [go-htmx](https://github.com/ConflictHQ/boilerworks-go-htmx) | Go + Chi | HTMX + Templ |
86
+| [fastapi-htmx](https://github.com/ConflictHQ/boilerworks-fastapi-htmx) | FastAPI | HTMX + Alpine.js |
87
+| [saleor-nextjs](https://github.com/ConflictHQ/boilerworks-saleor-nextjs) | Saleor (Django) | Next.js 16 |
8888
8989
### Micro Templates (6)
9090
91
-| Name | Backend | Status |
92
-|------|---------|--------|
93
-| fastapi-micro | FastAPI | 🔨 Building |
94
-| django-micro | Django 5 (DRF/Ninja) | 📋 Planned |
95
-| nestjs-micro | NestJS 11 | 📋 Planned |
96
-| go-micro | Go + Chi/Echo | 📋 Planned |
97
-| cherrypy-micro | CherryPy | 📋 Planned |
98
-| rust-micro | Axum (Rust) | 📋 Planned |
91
+| Name | Backend |
92
+|------|---------|
93
+| [django-micro](https://github.com/ConflictHQ/boilerworks-django-micro) | Django 5 (DRF/Ninja) |
94
+| [fastapi-micro](https://github.com/ConflictHQ/boilerworks-fastapi-micro) | FastAPI |
95
+| [nestjs-micro](https://github.com/ConflictHQ/boilerworks-nestjs-micro) | NestJS 11 |
96
+| [go-micro](https://github.com/ConflictHQ/boilerworks-go-micro) | Go + Chi |
97
+| [rust-micro](https://github.com/ConflictHQ/boilerworks-rust-micro) | Axum (Rust) |
98
+| [cherrypy-micro](https://github.com/ConflictHQ/boilerworks-cherrypy-micro) | CherryPy |
9999
100100
### Edge Templates (5)
101101
102
-| Name | Framework | Status |
103
-|------|-----------|--------|
104
-| hono-micro | Hono | 📋 Planned |
105
-| sveltekit-full | SvelteKit | 📋 Planned |
106
-| nuxt-full | Nuxt 4 | 📋 Planned |
107
-| remix-full | Remix | 📋 Planned |
108
-| astro-site | Astro | 📋 Planned |
102
+| Name | Framework |
103
+|------|-----------|
104
+| [sveltekit-full](https://github.com/ConflictHQ/boilerworks-sveltekit-full) | SvelteKit |
105
+| [remix-full](https://github.com/ConflictHQ/boilerworks-remix-full) | Remix |
106
+| [hono-micro](https://github.com/ConflictHQ/boilerworks-hono-micro) | Hono (Cloudflare Workers) |
107
+| [nuxt-full](https://github.com/ConflictHQ/boilerworks-nuxt-full) | Nuxt 4 |
108
+| [astro-site](https://github.com/ConflictHQ/boilerworks-astro-site) | Astro |
109109
110110
---
111111
112112
## Commands
113113
@@ -114,17 +114,15 @@
114114
```bash
115115
boilerworks --help # show all commands
116116
boilerworks list # show all 26 templates
117117
boilerworks list --size micro # filter by size
118118
boilerworks list --language python # filter by language
119
-boilerworks list --status done # filter by status
120119
boilerworks setup # interactive wizard
121120
boilerworks init # generate project from boilerworks.yaml
122121
boilerworks init --dry-run # preview what would happen
123122
boilerworks init --manifest ./path/to/boilerworks.yaml
124123
boilerworks init --output /path/to/output
125
-boilerworks bootstrap # show infrastructure plan (v2)
126124
```
127125
128126
---
129127
130128
## boilerworks.yaml
@@ -135,19 +133,19 @@
135133
project: my-app
136134
family: django-nextjs
137135
size: full
138136
topology: standard
139137
cloud: aws
138
+ops: true
140139
region: us-east-1
141140
domain: myapp.com
142141
mobile: false
143142
web_presence: false
144143
compliance:
145144
- soc2
146145
services:
147146
email: ses
148
- storage: s3
149147
cache: redis
150148
data:
151149
database: postgres
152150
migrations: true
153151
seed_data: true
@@ -163,21 +161,30 @@
163161
164162
## What Every Template Includes
165163
166164
Every Boilerworks Full template ships with:
167165
168
-- **Auth** — session-based (httpOnly cookies), SHA256-hashed tokens
166
+- **Auth** — session-based (httpOnly cookies), bcrypt passwords
169167
- **Permissions** — group-based, per-operation, checked at every endpoint
170168
- **Background jobs** — Redis-backed queue, retries, dead-letter handling
171
-- **File storage** — S3/MinIO with upload validation
172
-- **Search** — full-text search engine integration
173169
- **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally)
174
-- **Admin** — authenticated management interface
170
+- **Admin** — authenticated management interface with CRUD for all models
175171
- **Docker Compose** — one command to boot the full stack
176172
- **CI/CD** — GitHub Actions: lint, test, build, audit
177173
- **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md
178174
175
+---
176
+
177
+## Infrastructure
178
+
179
+Pair any template with [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) for production Terraform:
180
+
181
+- **AWS** — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager
182
+- **GCP / Azure** — structured stubs ready for expansion
183
+
184
+Select a cloud in `boilerworks setup` and `boilerworks init` will clone and configure the ops repo alongside your app.
185
+
179186
---
180187
181188
## Contributing
182189
183190
See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process.
@@ -187,10 +194,11 @@
187194
---
188195
189196
## Links
190197
191198
- Documentation: [boilerworks.dev](https://boilerworks.dev)
199
+- Product: [boilerworks.ai](https://boilerworks.ai)
192200
- Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ)
193201
194202
---
195203
196204
Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC.
197205
--- README.md
+++ README.md
@@ -2,11 +2,11 @@
2
3 **Production-ready project templates — assembled in seconds.**
4
5 Boilerworks is a CLI that clones and configures any of 26 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.
6
7 ```
8 pip install boilerworks
9 boilerworks setup # interactive wizard → writes boilerworks.yaml
10 boilerworks init # clone + configure the template
11 cd my-project
12 docker compose up -d # full stack running in seconds
@@ -66,48 +66,48 @@
66 | **Micro** | API services | API-key auth | VPS, containers |
67 | **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages |
68
69 ### Full Templates (15)
70
71 | Name | Backend | Frontend | Status |
72 |------|---------|----------|--------|
73 | django-nextjs | Django 5 | Next.js 16 | ✅ Done |
74 | nestjs-nextjs | NestJS 11 | Next.js 16 | ✅ Done |
75 | django-htmx | Django 5 | HTMX + Alpine.js | 🔨 Building |
76 | saleor-nextjs | Saleor (Django) | Next.js 16 | 🔨 Building |
77 | rails-hotwire | Rails 8 | Hotwire | 🔨 Building |
78 | laravel-vue | Laravel 11 | Inertia + Vue 3 | 🔨 Building |
79 | fastapi-nextjs | FastAPI | Next.js 16 | 🔨 Building |
80 | fastapi-htmx | FastAPI | HTMX + Alpine.js | 📋 Planned |
81 | spring-angular | Spring Boot 3 | Angular 19 | 📋 Planned |
82 | go-htmx | Go + Chi/Echo | HTMX + Templ | 📋 Planned |
83 | rails-nextjs | Rails 8 | Next.js 16 | 📋 Planned |
84 | phoenix-liveview | Phoenix 1.7 | LiveView | 📋 Planned |
85 | spring-nextjs | Spring Boot 3 | Next.js 16 | 📋 Planned |
86 | go-nextjs | Go + Chi/Echo | Next.js 16 | 📋 Planned |
87 | laravel-livewire | Laravel 11 | Livewire 3 | 📋 Planned |
88
89 ### Micro Templates (6)
90
91 | Name | Backend | Status |
92 |------|---------|--------|
93 | fastapi-micro | FastAPI | 🔨 Building |
94 | django-micro | Django 5 (DRF/Ninja) | 📋 Planned |
95 | nestjs-micro | NestJS 11 | 📋 Planned |
96 | go-micro | Go + Chi/Echo | 📋 Planned |
97 | cherrypy-micro | CherryPy | 📋 Planned |
98 | rust-micro | Axum (Rust) | 📋 Planned |
99
100 ### Edge Templates (5)
101
102 | Name | Framework | Status |
103 |------|-----------|--------|
104 | hono-micro | Hono | 📋 Planned |
105 | sveltekit-full | SvelteKit | 📋 Planned |
106 | nuxt-full | Nuxt 4 | 📋 Planned |
107 | remix-full | Remix | 📋 Planned |
108 | astro-site | Astro | 📋 Planned |
109
110 ---
111
112 ## Commands
113
@@ -114,17 +114,15 @@
114 ```bash
115 boilerworks --help # show all commands
116 boilerworks list # show all 26 templates
117 boilerworks list --size micro # filter by size
118 boilerworks list --language python # filter by language
119 boilerworks list --status done # filter by status
120 boilerworks setup # interactive wizard
121 boilerworks init # generate project from boilerworks.yaml
122 boilerworks init --dry-run # preview what would happen
123 boilerworks init --manifest ./path/to/boilerworks.yaml
124 boilerworks init --output /path/to/output
125 boilerworks bootstrap # show infrastructure plan (v2)
126 ```
127
128 ---
129
130 ## boilerworks.yaml
@@ -135,19 +133,19 @@
135 project: my-app
136 family: django-nextjs
137 size: full
138 topology: standard
139 cloud: aws
 
140 region: us-east-1
141 domain: myapp.com
142 mobile: false
143 web_presence: false
144 compliance:
145 - soc2
146 services:
147 email: ses
148 storage: s3
149 cache: redis
150 data:
151 database: postgres
152 migrations: true
153 seed_data: true
@@ -163,21 +161,30 @@
163
164 ## What Every Template Includes
165
166 Every Boilerworks Full template ships with:
167
168 - **Auth** — session-based (httpOnly cookies), SHA256-hashed tokens
169 - **Permissions** — group-based, per-operation, checked at every endpoint
170 - **Background jobs** — Redis-backed queue, retries, dead-letter handling
171 - **File storage** — S3/MinIO with upload validation
172 - **Search** — full-text search engine integration
173 - **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally)
174 - **Admin** — authenticated management interface
175 - **Docker Compose** — one command to boot the full stack
176 - **CI/CD** — GitHub Actions: lint, test, build, audit
177 - **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md
178
 
 
 
 
 
 
 
 
 
 
 
179 ---
180
181 ## Contributing
182
183 See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process.
@@ -187,10 +194,11 @@
187 ---
188
189 ## Links
190
191 - Documentation: [boilerworks.dev](https://boilerworks.dev)
 
192 - Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ)
193
194 ---
195
196 Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC.
197
--- README.md
+++ README.md
@@ -2,11 +2,11 @@
2
3 **Production-ready project templates — assembled in seconds.**
4
5 Boilerworks is a CLI that clones and configures any of 26 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.
6
7 ```bash
8 pip install boilerworks
9 boilerworks setup # interactive wizard → writes boilerworks.yaml
10 boilerworks init # clone + configure the template
11 cd my-project
12 docker compose up -d # full stack running in seconds
@@ -66,48 +66,48 @@
66 | **Micro** | API services | API-key auth | VPS, containers |
67 | **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages |
68
69 ### Full Templates (15)
70
71 | Name | Backend | Frontend |
72 |------|---------|----------|
73 | [django-nextjs](https://github.com/ConflictHQ/boilerworks-django-nextjs) | Django 5 | Next.js 16 |
74 | [nestjs-nextjs](https://github.com/ConflictHQ/boilerworks-nestjs-nextjs) | NestJS 11 | Next.js 16 |
75 | [rails-hotwire](https://github.com/ConflictHQ/boilerworks-rails-hotwire) | Rails 8 | Hotwire + Tailwind |
76 | [rails-nextjs](https://github.com/ConflictHQ/boilerworks-rails-nextjs) | Rails 8 | Next.js 16 |
77 | [spring-angular](https://github.com/ConflictHQ/boilerworks-spring-angular) | Spring Boot 3 | Angular 19 |
78 | [go-nextjs](https://github.com/ConflictHQ/boilerworks-go-nextjs) | Go + Chi | Next.js 16 |
79 | [phoenix-liveview](https://github.com/ConflictHQ/boilerworks-phoenix-liveview) | Phoenix 1.7 | LiveView |
80 | [laravel-vue](https://github.com/ConflictHQ/boilerworks-laravel-vue) | Laravel 12 | Inertia + Vue 3 |
81 | [django-htmx](https://github.com/ConflictHQ/boilerworks-django-htmx) | Django 5 | HTMX + Alpine.js |
82 | [fastapi-nextjs](https://github.com/ConflictHQ/boilerworks-fastapi-nextjs) | FastAPI | Next.js 16 |
83 | [spring-nextjs](https://github.com/ConflictHQ/boilerworks-spring-nextjs) | Spring Boot 3 | Next.js 16 |
84 | [laravel-livewire](https://github.com/ConflictHQ/boilerworks-laravel-livewire) | Laravel 12 | Livewire 3 |
85 | [go-htmx](https://github.com/ConflictHQ/boilerworks-go-htmx) | Go + Chi | HTMX + Templ |
86 | [fastapi-htmx](https://github.com/ConflictHQ/boilerworks-fastapi-htmx) | FastAPI | HTMX + Alpine.js |
87 | [saleor-nextjs](https://github.com/ConflictHQ/boilerworks-saleor-nextjs) | Saleor (Django) | Next.js 16 |
88
89 ### Micro Templates (6)
90
91 | Name | Backend |
92 |------|---------|
93 | [django-micro](https://github.com/ConflictHQ/boilerworks-django-micro) | Django 5 (DRF/Ninja) |
94 | [fastapi-micro](https://github.com/ConflictHQ/boilerworks-fastapi-micro) | FastAPI |
95 | [nestjs-micro](https://github.com/ConflictHQ/boilerworks-nestjs-micro) | NestJS 11 |
96 | [go-micro](https://github.com/ConflictHQ/boilerworks-go-micro) | Go + Chi |
97 | [rust-micro](https://github.com/ConflictHQ/boilerworks-rust-micro) | Axum (Rust) |
98 | [cherrypy-micro](https://github.com/ConflictHQ/boilerworks-cherrypy-micro) | CherryPy |
99
100 ### Edge Templates (5)
101
102 | Name | Framework |
103 |------|-----------|
104 | [sveltekit-full](https://github.com/ConflictHQ/boilerworks-sveltekit-full) | SvelteKit |
105 | [remix-full](https://github.com/ConflictHQ/boilerworks-remix-full) | Remix |
106 | [hono-micro](https://github.com/ConflictHQ/boilerworks-hono-micro) | Hono (Cloudflare Workers) |
107 | [nuxt-full](https://github.com/ConflictHQ/boilerworks-nuxt-full) | Nuxt 4 |
108 | [astro-site](https://github.com/ConflictHQ/boilerworks-astro-site) | Astro |
109
110 ---
111
112 ## Commands
113
@@ -114,17 +114,15 @@
114 ```bash
115 boilerworks --help # show all commands
116 boilerworks list # show all 26 templates
117 boilerworks list --size micro # filter by size
118 boilerworks list --language python # filter by language
 
119 boilerworks setup # interactive wizard
120 boilerworks init # generate project from boilerworks.yaml
121 boilerworks init --dry-run # preview what would happen
122 boilerworks init --manifest ./path/to/boilerworks.yaml
123 boilerworks init --output /path/to/output
 
124 ```
125
126 ---
127
128 ## boilerworks.yaml
@@ -135,19 +133,19 @@
133 project: my-app
134 family: django-nextjs
135 size: full
136 topology: standard
137 cloud: aws
138 ops: true
139 region: us-east-1
140 domain: myapp.com
141 mobile: false
142 web_presence: false
143 compliance:
144 - soc2
145 services:
146 email: ses
 
147 cache: redis
148 data:
149 database: postgres
150 migrations: true
151 seed_data: true
@@ -163,21 +161,30 @@
161
162 ## What Every Template Includes
163
164 Every Boilerworks Full template ships with:
165
166 - **Auth** — session-based (httpOnly cookies), bcrypt passwords
167 - **Permissions** — group-based, per-operation, checked at every endpoint
168 - **Background jobs** — Redis-backed queue, retries, dead-letter handling
 
 
169 - **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally)
170 - **Admin** — authenticated management interface with CRUD for all models
171 - **Docker Compose** — one command to boot the full stack
172 - **CI/CD** — GitHub Actions: lint, test, build, audit
173 - **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md
174
175 ---
176
177 ## Infrastructure
178
179 Pair any template with [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) for production Terraform:
180
181 - **AWS** — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager
182 - **GCP / Azure** — structured stubs ready for expansion
183
184 Select a cloud in `boilerworks setup` and `boilerworks init` will clone and configure the ops repo alongside your app.
185
186 ---
187
188 ## Contributing
189
190 See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process.
@@ -187,10 +194,11 @@
194 ---
195
196 ## Links
197
198 - Documentation: [boilerworks.dev](https://boilerworks.dev)
199 - Product: [boilerworks.ai](https://boilerworks.ai)
200 - Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ)
201
202 ---
203
204 Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC.
205

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button