nextjs-nestjs-integration

Original：🇺🇸 English

Translated

10 scripts

Use for real projects that combine a Next.js frontend/BFF with a NestJS API. Covers ownership boundaries, OpenAPI client generation, session and auth propagation, CORS/proxy contracts, Server Component data fetching, shared environment contracts, and split deployment/runtime alignment.

5installs

Sourcexirothedev/skills

Added on2026-10-16

NPX Install

npx skill4agent add xirothedev/skills nextjs-nestjs-integration

SKILL.md Content

View Translation Comparison →

Next.js NestJS Integration

Use this skill when a project has both a Next.js app and a NestJS API. The main job is to keep ownership boundaries clear so the web app does not accidentally duplicate backend policy, bypass API contracts, or self-fetch at build time.

When to Apply

Use this skill when:

Generating or consuming typed clients from a NestJS OpenAPI document
Deciding whether logic belongs in Next.js Route Handlers/Server Actions or NestJS controllers/services
Propagating auth/session context from Next.js to NestJS
Configuring CORS, cookies, Proxy, rewrites, or internal API origins
Fetching NestJS data from Server Components without calling the Next.js app's own Route Handlers
Aligning Docker, environment variables, health checks, and deployment topology across apps

Load On Demand

Start with this file. Load detailed files only when the task needs them:

references/_sections.md
references/integration-openapi-client-boundary.md
references/integration-session-propagation.md
references/integration-cors-proxy-contract.md
references/integration-server-component-fetching.md
references/integration-shared-env-contract.md
references/integration-deployment-split.md
dataset/integration/openapi-client-boundary/correct.ts
sources/inventory.json

Each rule file includes:

Why the pattern matters
Incorrect and correct examples
Dataset path with larger TypeScript examples
Official source references

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Integration Boundaries	CRITICAL	`integration-`
2	API Contracts	CRITICAL	`api-`
3	Deployment & Operations	HIGH	`deploy-`

Source Policy

Use this skill together with

nextjs-secure-bff

,

nextjs-production-platform

, and

nestjs-production-api-contracts

when the work spans both apps. Official Next.js and NestJS docs outrank framework-agnostic monorepo examples.