NestJS API on Node

A TypeScript JSON API on NestJS served by Node, with feature modules, class-validator DTOs behind a global validation pipe, one exception filter rendering every error as the same envelope, request ids and JSON logs, Swagger docs, and Vitest unit specs plus Supertest contract tests on the real app module.

What done means

Your agent follows the brief, then runs stacks verify without weakening or skipping checks. What happens next

Declared steps: install, lint, typecheck, test, e2e, build, api, readme-filled. View commands

Use this stack

Paste the prompt into the coding agent working on your project.

Full projectQuick local experiment

Uses the stack’s default fragments. Review the brief with your agent.Uses stated defaults and omits deploy, release, and app fragments unless explicitly requested.

View prompt

Use the nestjs-api stack for this project. 1. Run npx @steamfield/stacks show nestjs-api --json and check that it fits the project. If it does not, explain why before changing files. 2. Run npx @steamfield/stacks new nestjs-api and follow the brief it prints. 3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps. 4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size. The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.

Use the nestjs-api stack for a quick local experiment. 1. Run npx @steamfield/stacks show nestjs-api --json and check that it fits the project. If it does not, explain why before changing files. 2. Run npx @steamfield/stacks new nestjs-api --sandbox and follow the brief it prints. 3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps. 4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size. The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.

Or use the terminal

npx @steamfield/stacks new nestjs-api

npx @steamfield/stacks new nestjs-api --sandbox

Verify steps
Step	Phase	Layer	Command
install	setup	install	`bun install`
lint	check	lint	`bun run lint`
typecheck	check	typecheck	`bun run typecheck`
test	check	test	`bun run test`
e2e	check	test	`bun run test:e2e`
build	check	build	`bun run build`
api	serve	serve	`bun run start`
readme-filled	check	check	`test -s README.md && ! grep -n 'stacks:fill' README.md`

Required fragments

claude-harness

Default fragments

Optional fragments

Dependencies
Role	Packages
app	@nestjs/common, @nestjs/core, @nestjs/platform-express, @nestjs/config, @nestjs/swagger, reflect-metadata, rxjs, class-validator, class-transformer
dev	@nestjs/cli, @nestjs/schematics, @nestjs/testing, typescript, @types/node, @types/express, vitest, @vitest/coverage-v8, supertest, @types/supertest, oxlint, oxlint-tsgolint, prettier

Tools

bun · node · git

Usage and outcomes

Usage over time

Showing 180 days of history.

History

The 28-day green rate at each weekly observation. Gaps mean the sample was too small to publish.

Shaded band: 95% Wilson interval. Dashed rules: content changes. Missing observations remain gaps.

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

Data table

Through	Green rate	Projects	Content change
5 Jul 2026	hidden: too few projects	–	–
12 Jul 2026	hidden: too few projects	520	–
19 Jul 2026	hidden: too few projects	1,095	–
26 Jul 2026	hidden: too few projects	1,975	–
2 Aug 2026	hidden: too few projects	2,935	–
9 Aug 2026	hidden: too few projects	3,365	–
16 Aug 2026	hidden: too few projects	3,855	–
23 Aug 2026	hidden: too few projects	4,165	–
30 Aug 2026	hidden: too few projects	4,490	–
6 Sept 2026	hidden: too few projects	4,830	–
13 Sept 2026	hidden: too few projects	5,190	–
20 Sept 2026	hidden: too few projects	5,455	–
27 Sept 2026	hidden: too few projects	5,770	–
4 Oct 2026	hidden: too few projects	6,180	–
11 Oct 2026	hidden: too few projects	6,445	–
18 Oct 2026	hidden: too few projects	6,805	–
25 Oct 2026	hidden: too few projects	7,065	–
1 Nov 2026	hidden: too few projects	7,360	–

Weekly projects by preset

Non-overlapping seven-day project counts, grouped by the preset used to start the project.

default
sandbox

Stacks projects per UTC week through 4 Nov 2026. Published preset counts only; hidden cells are not zero.

Data table

Week ending	Preset	Projects
5 Jul 2026	default	–
12 Jul 2026	default	355
19 Jul 2026	default	385
26 Jul 2026	default	575
2 Aug 2026	default	640
9 Aug 2026	default	640
16 Aug 2026	default	700
23 Aug 2026	default	780
30 Aug 2026	default	830
6 Sept 2026	default	830
13 Sept 2026	default	940
20 Sept 2026	default	930
27 Sept 2026	default	1,035
4 Oct 2026	default	1,110
11 Oct 2026	default	1,095
18 Oct 2026	default	1,140
25 Oct 2026	default	1,225
1 Nov 2026	default	1,340
5 Jul 2026	sandbox	–
12 Jul 2026	sandbox	165
19 Jul 2026	sandbox	190
26 Jul 2026	sandbox	305
2 Aug 2026	sandbox	320
9 Aug 2026	sandbox	310
16 Aug 2026	sandbox	365
23 Aug 2026	sandbox	410
30 Aug 2026	sandbox	455
6 Sept 2026	sandbox	455
13 Sept 2026	sandbox	490
20 Sept 2026	sandbox	520
27 Sept 2026	sandbox	565
4 Oct 2026	sandbox	590
11 Oct 2026	sandbox	600
18 Oct 2026	sandbox	670
25 Oct 2026	sandbox	635
1 Nov 2026	sandbox	650

By preset

Green verify outcomes by the preset chosen at scaffold time.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

By agent

Within this stack, listed alphabetically. These are project outcomes, not an agent ranking.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

Time to green

Published time summaries on a shared minutes scale. First passing test is a median; 75% reached green by the 75th percentile.

Median to green: –
75th percentile: –
First passing test: –
Verify runs to green: –

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

Data table

Measure	Time / runs
Median to green	–
75th percentile	–
First passing test	–
Verify runs to green	–

Where it breaks

A run can fail more than one step. Environment failures are shown separately.

Environment blockedhidden: too few projects

Share of failed runs before first green. Environment blocked describes the machine, not the stack.

Data table

Step	Share
Environment blocked	–

What people change

Defaults people keep, and optional fragments they choose to attach.

Default, kept rate

claude-harness100%

git-hooks92%

ci-github92%

rest-api92%

Optional, attach rate

rr17%

ce-plugin18%

Share of the window's 6,750 projects. Kept rate is 1 minus the without rate.

Data table

Fragment	Measure	Share
claude-harness	Kept	100%
git-hooks	Kept	92%
ci-github	Kept	92%
rest-api	Kept	92%
rr	Attached	17%
ce-plugin	Attached	18%

By composition 31 fingerprints

Each row is a distinct fragment composition, with its own sample and content history.

Composition	Green rate	Seen	Change in life
defaults − git-hooks · 00c44e3e	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − git-hooks − rest-api · 08f2a0f5	hidden: too few projects	19 Jul 2026 – 1 Nov 2026	None
defaults − ci-github − git-hooks − rest-api · 0f48731d	hidden: too few projects	26 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − ci-github − git-hooks · 12ee22bc	hidden: too few projects	19 Jul 2026 – 1 Nov 2026	None
defaults + rr − rest-api · 228f7f79	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults − ci-github · 22c0b88e	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + rr − git-hooks − rest-api · 278b7946	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults · 2982cf0e	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − git-hooks − rest-api · 37a62220	hidden: too few projects	9 Aug 2026 – 1 Nov 2026	None
defaults + ce-plugin − git-hooks · 40355c6b	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + rr − ci-github − rest-api · 420c87fc	hidden: too few projects	9 Aug 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − git-hooks · 47ebe067	hidden: too few projects	19 Jul 2026 – 1 Nov 2026	None
defaults + rr − git-hooks · 509d7b17	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr · 55d945d7	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − ci-github − git-hooks · 570b3dbc	hidden: too few projects	30 Aug 2026 – 1 Nov 2026	None
defaults − ci-github − git-hooks · 5a117f3e	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults − ci-github − rest-api · 5cea3a98	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + rr − ci-github − git-hooks − rest-api · 6343bd94	hidden: too few projects	11 Oct 2026 – 1 Nov 2026	None
defaults + rr − ci-github · 6733cfbf	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − ci-github − rest-api · 6ae34675	hidden: too few projects	26 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − ci-github − rest-api · 70ebf44a	hidden: too few projects	9 Aug 2026 – 1 Nov 2026	None
defaults + ce-plugin − rest-api · 78201df9	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − ci-github · 7d0456e1	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin · 9f0b70b7	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − rest-api · a988be37	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + rr − ci-github − git-hooks · b488a7e4	hidden: too few projects	19 Jul 2026 – 1 Nov 2026	None
defaults − git-hooks − rest-api · b513a874	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + rr · bee45140	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − ci-github − git-hooks − rest-api · ca0ce3a1	hidden: too few projects	1 Nov 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − ci-github · d405f099	hidden: too few projects	19 Jul 2026 – 1 Nov 2026	None
defaults − rest-api · f51e5bc7	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None

Computed 5 Nov 2026, through 4 Nov 2026. Numbers describe stacks projects, not the ecosystem.