1# Template Selection Decision Tree — REFERENCE ONLY
2 
3**CRITICAL**: Check for specific scenario indicators IN ORDER before defaulting to Web API.
4 
5**Architecture**: All deployments start from a base template per language/scenario. Integrations are applied as [composable recipes](recipes/README.md) on top of the base. See [composition.md](recipes/composition.md) for the merge algorithm.
6 
7Cross-reference with [App Service overview](https://learn.microsoft.com/en-us/azure/app-service/overview) and [official AZD gallery templates](https://azure.github.io/awesome-azd/?tags=appservice).
8 
9```
101. Is this a full-stack web app with server-side rendering?
11   Indicators: Razor Pages, MVC views, Next.js SSR, Nuxt, Django templates,
12               server-rendered HTML, .cshtml, EJS/Pug, Jinja2
13   └─► YES → web-app base template (see [web-app.md](web-app.md))
14 
152. Is this a background worker or WebJob?
16   Indicators: WebJob, IHostedService, BackgroundService, worker,
17               queue processor, scheduled task (no HTTP endpoints)
18   └─► YES → Use Worker Service template (out of scope — see Functions or Container Apps)
19 
203. Does it use Azure SQL or PostgreSQL?
21   Indicators: DbContext, EF Core, Prisma, SQLAlchemy, connection string,
22               Microsoft.EntityFrameworkCore, @prisma/client, psycopg2
23   └─► YES → Web API base + sql recipe (IaC + RBAC + source)
24   Recipe: recipes/sql/ ✅ Available
25 
264. Does it use Cosmos DB?
27   Indicators: CosmosClient, @azure/cosmos, azure-cosmos, CosmosDBConnection,
28               Microsoft.Azure.Cosmos, container.read_item
29   └─► YES → Web API base + cosmos recipe (IaC + RBAC + source)
30   Recipe: recipes/cosmos/ ✅ Available
31 
325. Does it require authentication?
33   Indicators: [Authorize], Microsoft.Identity.Web, passport-azure-ad,
34               msal, EasyAuth, /.auth/login, authsettingsV2
35   └─► YES → base + auth recipe (Easy Auth or MSAL config)
36   Recipe: recipes/auth/ ✅ Available
37 
386. Does it use Redis caching?
39   Indicators: IDistributedCache, StackExchange.Redis, ioredis, redis,
40               azure-cache-redis, aioredis
41   └─► YES → base + redis recipe (IaC + RBAC + source)
42   Recipe: recipes/redis/ ✅ Available
43 
447. DEFAULT → Web API base template by runtime (see [web-api.md](web-api.md))
45```
46 
47## Base Templates
48 
49| Scenario | Template Reference |
50|----------|-------------------|
51| Full-stack web app with server-side rendering | [web-app.md](web-app.md) |
52| REST API / headless backend (default) | [web-api.md](web-api.md) |
53 
54## Recipe Types
55 
56| Type | IaC Delta? | Examples |
57|------|-----------|----------|
58| **Full recipe** | Yes — Bicep module + RBAC + networking | sql, cosmos, redis, auth |
59| **Source-only** | No — only application code patterns | health checks |
60 
61## Critical Rules
62 
63> See [Critical Rules](recipes/composition.md#critical-rules) in composition.md (canonical).
64