Skip to content

Commit dfc161f

Browse files
chore: update docs and recipes for CNA-parity extension slugs
Replace python-* addon examples with fastapi-*/django-*/celery-docker and all-* catalog slugs so the website matches cpa-templates. Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent a781813 commit dfc161f

13 files changed

Lines changed: 247 additions & 209 deletions

File tree

src/app/docs/advanced/usage/page.tsx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -113,12 +113,12 @@ uv remove unused-package`}
113113
<div className="rounded-lg border p-4">
114114
<h3 className="text-lg font-semibold mb-2">Docker</h3>
115115
<p className="text-sm text-muted-foreground">
116-
The <code>python-docker</code> extension adds a Dockerfile and Compose files for local and production
116+
The <code>fastapi-docker</code> extension adds a Dockerfile and Compose files for local and production
117117
container runs.
118118
</p>
119119
<div className="mt-4">
120120
<pre className="text-xs bg-muted p-2 rounded-md overflow-x-auto">
121-
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons python-docker
121+
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons fastapi-docker
122122
</pre>
123123
</div>
124124
</div>

src/app/docs/extensions/page.tsx

Lines changed: 21 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,15 @@
1-
import { ArrowLeft, ArrowRight, Cloud, Code, Container, Database, Monitor, Shield, Terminal, Wrench } from 'lucide-react';
1+
import {
2+
ArrowLeft,
3+
ArrowRight,
4+
Cloud,
5+
Code,
6+
Container,
7+
Database,
8+
Monitor,
9+
Shield,
10+
Terminal,
11+
Wrench,
12+
} from 'lucide-react';
213
import type { Metadata } from 'next';
314
import Link from 'next/link';
415

@@ -24,25 +35,25 @@ const categories = [
2435
name: 'Containers',
2536
description: 'Docker images and Compose stacks for local and production runs.',
2637
icon: <Container className="h-5 w-5 text-primary" />,
27-
examples: ['python-docker'],
38+
examples: ['fastapi-docker', 'django-docker', 'celery-docker'],
2839
},
2940
{
3041
name: 'Database',
3142
description: 'PostgreSQL services, ORM helpers, and migration scaffolding.',
3243
icon: <Database className="h-5 w-5 text-primary" />,
33-
examples: ['python-postgres', 'python-sqlalchemy', 'python-redis'],
44+
examples: ['postgres', 'fastapi-sqlalchemy', 'fastapi-redis'],
3445
},
3546
{
3647
name: 'Observability',
3748
description: 'Error tracking and production diagnostics.',
3849
icon: <Monitor className="h-5 w-5 text-primary" />,
39-
examples: ['python-sentry'],
50+
examples: ['fastapi-sentry'],
4051
},
4152
{
4253
name: 'Security',
4354
description: 'Authentication and authorization skeletons.',
4455
icon: <Shield className="h-5 w-5 text-primary" />,
45-
examples: ['python-auth-jwt'],
56+
examples: ['fastapi-auth-jwt'],
4657
},
4758
{
4859
name: 'CI & GitHub',
@@ -54,19 +65,19 @@ const categories = [
5465
name: 'Developer Experience',
5566
description: 'Editor integrations and remote development environments.',
5667
icon: <Terminal className="h-5 w-5 text-primary" />,
57-
examples: ['python-devcontainer'],
68+
examples: ['development-container'],
5869
},
5970
{
6071
name: 'API & Services',
6172
description: 'Backend-focused add-ons for FastAPI and similar templates.',
6273
icon: <Code className="h-5 w-5 text-primary" />,
63-
examples: ['python-sqlalchemy', 'python-redis', 'python-auth-jwt'],
74+
examples: ['fastapi-sqlalchemy', 'fastapi-redis', 'fastapi-auth-jwt'],
6475
},
6576
{
6677
name: 'Tooling',
6778
description: 'Cross-cutting workflow improvements for Python projects.',
6879
icon: <Wrench className="h-5 w-5 text-primary" />,
69-
examples: ['github-setup', 'python-devcontainer'],
80+
examples: ['github-setup', 'development-container'],
7081
},
7182
];
7283

@@ -102,8 +113,8 @@ export default function DocsExtensionsPage() {
102113
<div className="rounded-md bg-muted p-4">
103114
<pre className="text-sm overflow-x-auto">
104115
<code>
105-
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons python-docker
106-
python-postgres github-setup
116+
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons fastapi-docker
117+
postgres github-setup
107118
</code>
108119
</pre>
109120
</div>

src/app/docs/installation/page.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -327,7 +327,7 @@ makepkg -si`}</pre>
327327
<pre className="text-sm font-mono overflow-x-auto">{`docker run --rm -it \\
328328
-v "\${PWD}:/app" -w /app \\
329329
ulisesjeremias/create-awesome-python-app:0.2.0 \\
330-
my-app --template fastapi-starter --addons python-docker github-setup --no-interactive`}</pre>
330+
my-app --template fastapi-starter --addons fastapi-docker github-setup --no-interactive`}</pre>
331331
</div>
332332
</div>
333333
<div>

src/app/docs/page.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -324,7 +324,7 @@ export default function DocsPage() {
324324
<div className="rounded-md bg-muted p-4 mt-2">
325325
<pre className="text-sm">
326326
<code>
327-
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons python-docker
327+
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons fastapi-docker
328328
github-setup
329329
</code>
330330
</pre>

src/app/docs/templates/customization/TemplateCustomizationClientPage.tsx

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,7 @@ export default function TemplateCustomizationClientPage() {
3131
<FileCode className="h-5 w-5 text-primary" />
3232
Project Structure Customization
3333
</h3>
34-
<p>
35-
After scaffolding, reorganize modules to match your domain. Common patterns across CPA templates:
36-
</p>
34+
<p>After scaffolding, reorganize modules to match your domain. Common patterns across CPA templates:</p>
3735

3836
<div className="grid gap-4 md:grid-cols-2 mt-4">
3937
<div className="rounded-lg border p-4">
@@ -230,13 +228,13 @@ uv remove unused-package`}
230228
<ul className="list-disc pl-6 space-y-2">
231229
<li>
232230
<strong>Routers:</strong> Register new routers in the app factory; pair with{' '}
233-
<code>python-sqlalchemy</code> or <code>python-auth-jwt</code> when needed.
231+
<code>fastapi-sqlalchemy</code> or <code>fastapi-auth-jwt</code> when needed.
234232
</li>
235233
<li>
236234
<strong>Settings:</strong> Extend the generated <code>Settings</code> class for new env vars.
237235
</li>
238236
<li>
239-
<strong>Observability:</strong> Add <code>python-sentry</code> during scaffold or wire Sentry
237+
<strong>Observability:</strong> Add <code>fastapi-sentry</code> during scaffold or wire Sentry
240238
manually in lifespan hooks.
241239
</li>
242240
</ul>
@@ -262,11 +260,13 @@ app.include_router(users.router, prefix="/users", tags=["users"])`}
262260
<code>INSTALLED_APPS</code>.
263261
</li>
264262
<li>
265-
<strong>DRF:</strong> Define serializers and viewsets; keep URL routing in{' '}
266-
<code>urls.py</code>.
263+
<strong>DRF:</strong> Define serializers and viewsets; keep URL routing in <code>urls.py</code>.
264+
</li>
265+
<li>
266+
<strong>Database:</strong> Pair with <code>postgres</code> for local Compose services.
267267
</li>
268268
<li>
269-
<strong>Database:</strong> Pair with <code>python-postgres</code> for local Compose services.
269+
<strong>Containers:</strong> Add <code>django-docker</code> for gunicorn/runserver images.
270270
</li>
271271
</ul>
272272
</div>
@@ -311,8 +311,8 @@ def greet(name: str) -> None:
311311
<strong>Shared tooling:</strong> Keep Ruff/pytest config at the workspace root.
312312
</li>
313313
<li>
314-
<strong>Running:</strong> Use <code>uv run --package &lt;member&gt; ...</code> to target a specific
315-
app or library.
314+
<strong>Running:</strong> Use <code>uv run --package &lt;member&gt; ...</code> to target a
315+
specific app or library.
316316
</li>
317317
</ul>
318318
</div>
@@ -327,7 +327,9 @@ def greet(name: str) -> None:
327327
<div className="space-y-6 mt-6">
328328
<div className="space-y-2">
329329
<h3 className="text-xl font-semibold">Environment Variables</h3>
330-
<p>Use <code>.env</code> locally (never commit secrets) and typed settings in code:</p>
330+
<p>
331+
Use <code>.env</code> locally (never commit secrets) and typed settings in code:
332+
</p>
331333

332334
<div className="rounded-md bg-muted p-4 mt-4">
333335
<pre className="text-sm overflow-x-auto">
@@ -353,7 +355,7 @@ class Settings(BaseSettings):
353355
<div className="space-y-2">
354356
<h3 className="text-xl font-semibold">Docker & Compose</h3>
355357
<p>
356-
When you scaffold with <code>python-docker</code>, customize <code>Dockerfile</code>,{' '}
358+
When you scaffold with <code>fastapi-docker</code>, customize <code>Dockerfile</code>,{' '}
357359
<code>compose.yml</code>, and health checks for your deployment target. Rebuild with{' '}
358360
<code>docker compose up --build</code> after changes.
359361
</p>

src/app/docs/templates/page.tsx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -140,8 +140,8 @@ export default async function DocsTemplatesPage() {
140140
<div className="rounded-md bg-muted p-4">
141141
<pre className="text-sm overflow-x-auto">
142142
<code>
143-
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons python-docker
144-
python-postgres
143+
uvx create-awesome-python-app@latest my-app --template fastapi-starter --addons fastapi-docker
144+
postgres
145145
</code>
146146
</pre>
147147
</div>

src/app/page.tsx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -187,10 +187,10 @@ export default async function Home() {
187187
<div className="bg-muted rounded-md p-4 font-mono text-sm overflow-x-auto">
188188
<p className="text-green-700 dark:text-green-300">$ uvx create-awesome-python-app my-app \</p>
189189
<p className="pl-4">--template fastapi-starter \</p>
190-
<p className="pl-4">--addons python-docker github-setup</p>
190+
<p className="pl-4">--addons fastapi-docker github-setup</p>
191191
</div>
192192
<CopyButton
193-
command="uvx create-awesome-python-app my-app --template fastapi-starter --addons python-docker github-setup --no-interactive"
193+
command="uvx create-awesome-python-app my-app --template fastapi-starter --addons fastapi-docker github-setup --no-interactive"
194194
variant="outline"
195195
className="w-full"
196196
/>

src/components/animated-terminal.tsx

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ const STACKS = [
88
lines: [
99
{ prefix: '$', text: ' uvx create-awesome-python-app my-api', color: 'text-foreground' },
1010
{ prefix: '✔', text: ' Template fastapi-starter', color: 'text-green-400' },
11-
{ prefix: '✔', text: ' Extensions python-docker · github-setup · python-postgres', color: 'text-green-400' },
11+
{ prefix: '✔', text: ' Extensions fastapi-docker · github-setup · postgres', color: 'text-green-400' },
1212
{ prefix: '✔', text: ' Syncing with uv...', color: 'text-muted-foreground' },
1313
{ prefix: '✔', text: ' Ready. cd my-api && uv run uvicorn app.main:app --reload', color: 'text-primary' },
1414
],
@@ -18,7 +18,7 @@ const STACKS = [
1818
lines: [
1919
{ prefix: '$', text: ' uvx create-awesome-python-app my-cli', color: 'text-foreground' },
2020
{ prefix: '✔', text: ' Template cli-starter', color: 'text-green-400' },
21-
{ prefix: '✔', text: ' Extensions github-setup · python-devcontainer', color: 'text-green-400' },
21+
{ prefix: '✔', text: ' Extensions github-setup · development-container', color: 'text-green-400' },
2222
{ prefix: '✔', text: ' Syncing with uv...', color: 'text-muted-foreground' },
2323
{ prefix: '✔', text: ' Ready. cd my-cli && uv run my-cli --help', color: 'text-primary' },
2424
],
@@ -28,9 +28,13 @@ const STACKS = [
2828
lines: [
2929
{ prefix: '$', text: ' uvx create-awesome-python-app my-worker', color: 'text-foreground' },
3030
{ prefix: '✔', text: ' Template celery-worker', color: 'text-green-400' },
31-
{ prefix: '✔', text: ' Extensions python-redis · python-docker', color: 'text-green-400' },
31+
{ prefix: '✔', text: ' Extensions celery-docker · github-setup', color: 'text-green-400' },
3232
{ prefix: '✔', text: ' Syncing with uv...', color: 'text-muted-foreground' },
33-
{ prefix: '✔', text: ' Ready. cd my-worker && uv run celery -A app worker', color: 'text-primary' },
33+
{
34+
prefix: '✔',
35+
text: ' Ready. cd my-worker && uv run celery -A worker.celery_app worker --loglevel=INFO',
36+
color: 'text-primary',
37+
},
3438
],
3539
},
3640
];

src/components/recipes-section.tsx

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,10 @@ const recipes: Recipe[] = [
3131
templateFlag: '--template',
3232
templateValue: ' fastapi-starter ',
3333
addonsFlag: '--addons',
34-
addonsValue: ' python-docker github-setup',
34+
addonsValue: ' fastapi-docker github-setup',
3535
},
3636
rawCommand:
37-
'uvx create-awesome-python-app my-api --template fastapi-starter --addons python-docker github-setup --no-interactive',
37+
'uvx create-awesome-python-app my-api --template fastapi-starter --addons fastapi-docker github-setup --no-interactive',
3838
href: '/templates/fastapi-starter',
3939
},
4040
{
@@ -47,42 +47,42 @@ const recipes: Recipe[] = [
4747
templateFlag: '--template',
4848
templateValue: ' cli-starter ',
4949
addonsFlag: '--addons',
50-
addonsValue: ' python-devcontainer github-setup',
50+
addonsValue: ' development-container github-setup',
5151
},
5252
rawCommand:
53-
'uvx create-awesome-python-app my-cli --template cli-starter --addons python-devcontainer github-setup --no-interactive',
53+
'uvx create-awesome-python-app my-cli --template cli-starter --addons development-container github-setup --no-interactive',
5454
href: '/templates/cli-starter',
5555
},
5656
{
5757
title: 'Celery worker',
58-
description: 'Background worker with Redis and Docker for async task pipelines.',
58+
description: 'Background worker with Celery Docker for async task pipelines.',
5959
icon: Workflow,
60-
labels: ['Celery', 'Redis', 'Docker', 'Workers'],
60+
labels: ['Celery', 'Docker', 'Workers', 'uv'],
6161
command: {
6262
base: 'uvx create-awesome-python-app my-worker ',
6363
templateFlag: '--template',
6464
templateValue: ' celery-worker ',
6565
addonsFlag: '--addons',
66-
addonsValue: ' python-redis python-docker',
66+
addonsValue: ' celery-docker github-setup',
6767
},
6868
rawCommand:
69-
'uvx create-awesome-python-app my-worker --template celery-worker --addons python-redis python-docker --no-interactive',
69+
'uvx create-awesome-python-app my-worker --template celery-worker --addons celery-docker github-setup --no-interactive',
7070
href: '/templates/celery-worker',
7171
},
7272
{
7373
title: 'Django API',
74-
description: 'Django API starter with Postgres and JWT auth extensions.',
74+
description: 'Django API starter with Postgres and Django Docker.',
7575
icon: Sparkles,
76-
labels: ['Django', 'Postgres', 'JWT', 'API'],
76+
labels: ['Django', 'Postgres', 'Docker', 'API'],
7777
command: {
7878
base: 'uvx create-awesome-python-app my-django ',
7979
templateFlag: '--template',
8080
templateValue: ' django-api ',
8181
addonsFlag: '--addons',
82-
addonsValue: ' python-postgres python-auth-jwt',
82+
addonsValue: ' postgres django-docker',
8383
},
8484
rawCommand:
85-
'uvx create-awesome-python-app my-django --template django-api --addons python-postgres python-auth-jwt --no-interactive',
85+
'uvx create-awesome-python-app my-django --template django-api --addons postgres django-docker --no-interactive',
8686
href: '/templates/django-api',
8787
},
8888
];

src/components/saas-ai-banner.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,7 @@ export function SaasAiBanner() {
112112
<div className="p-4 sm:p-6 font-mono text-sm leading-relaxed overflow-x-auto">
113113
<p className="text-green-400">$ uvx create-awesome-python-app my-api \</p>
114114
<p className="text-slate-300 pl-4">--template fastapi-starter \</p>
115-
<p className="text-slate-300 pl-4">--addons python-docker github-setup</p>
115+
<p className="text-slate-300 pl-4">--addons fastapi-docker github-setup</p>
116116
<p className="mt-4 text-slate-500"># ✅ FastAPI scaffold ready</p>
117117
<p className="text-slate-500"># ✅ uv workspace + typed settings</p>
118118
<p className="text-slate-500"># ✅ Compose Docker + CI extensions</p>

0 commit comments

Comments
 (0)