nextjs-tooling

Environment Variable Validation

Implementation Guidelines

Build: Use Turbopack (next dev --turbo) for faster incremental builds; Webpack for legacy.
Linting: Mandate next lint (eslint-plugin-next) and tsc in CI/CD.
Bundle Analysis: Inspect with @next/bundle-analyzer. Remove unused dependencies.
Telemetry: Opt-out via next telemetry disable if privacy required.
Environment: Server-only vars vs NEXT_PUBLIC_*. Validate with Zod at runtime.
CI/CD: Cache .next/cache in CI for 50%+ faster builds.

Anti-Patterns

No npm run start for dev: Use next dev (or next dev --turbo).
No uninspected bundle growth: Analyze with @next/bundle-analyzer before shipping.
No custom ESLint rules over plugin: Use eslint-plugin-next for Next.js-aware linting.
No console.log in production: Use structured loggers (Pino, Winston).

References

CI/CD & Deployment Guide

More from this repository

same repository

python-architecture

Structure Python backends with explicit dependency direction, ports/adapters, and runtime boundaries. Use when shaping project layout, clean architecture, service boundaries, dependency injection, report rendering boundaries, or transport separation in Python.

python-async-runtime

Write correct async Python runtime code with explicit blocking-I/O boundaries, cancellation, and timeout handling. Use when editing `asyncio` workflows, background loops, async services, or mixed sync/async integrations.

python-best-practices

Write maintainable Python with small functions, explicit boundaries, guard clauses, and readable state flow. Use when refactoring Python services, helpers, modules, or async logic for clarity.

python-database

Implement Python database access with parameterized SQL, transaction scope, connection helpers, and repository seams. Use when editing Postgres queries, repositories, transactions, pooling, or persistence boundaries in Python.

python-error-handling

Design Python error paths with narrow exceptions, rollback, contextual logs, and preserved blocker truth. Use when handling retries, verifier outcomes, parser failures, or exception flow in Python services.

python-language

Core Python 3.11+ standards for typing, dataclasses, imports, pathlib, and stdlib-first code. Use when editing Python modules, stubs, `pyproject.toml`, or choosing idiomatic Python constructs.

name	nextjs-tooling
description	Configure Next.js build tooling, deployment, and developer workflow. Use when setting up Turbopack, standalone Docker output, bundle analysis, CI caching, environment variable validation, or ESLint integration for Next.js projects.
metadata	{"triggers":{"files":["next.config.js","package.json"],"keywords":["Dockerfile","turbopack","output","standalone","lint","telemetry"]}}

Next.js Tooling

Priority: P2 (MEDIUM)

Standalone Docker Config

Environment Variable Validation