route-handlers

The route-handlers skill serves as an expert assistant for developers working within the Next.js App Router paradigm. It is designed to streamline the creation, configuration, and maintenance of server-side API endpoints using the standard Web Request and Response APIs. By providing contextual templates and best practices, it ensures that your API routes—defined in route.ts files—are robust, performant, and correctly structured to handle varying server-side requirements.

• Full support for standard HTTP methods including GET, POST, PUT, PATCH, DELETE, HEAD, and OPTIONS to define clear endpoint behaviors.

• Native handling for diverse request payloads, such as JSON parsing, form data extraction, and raw text processing.

• Dynamic route parameter management for complex URLs, allowing for efficient variable extraction and database querying via path segments.

• Advanced response handling features, including custom JSON responses, HTTP header injection, cookie management, and status code setting.

• High-performance streaming capabilities for both standard text streams and complex AI/LLM integration patterns using ReadableStream.

• Integrated security patterns for CORS configuration, providing boilerplate for OPTIONS methods to manage cross-origin traffic.

• Intelligent caching control, offering clear guidance on opting into or out of data caching via route segment configurations like force-dynamic.

• Ideal for backend developers, full-stack engineers, and API architects building on the Next.js framework.

• Best used when generating new API routes, refactoring endpoint logic, implementing middleware-style logic, or handling complex server-side data streaming.

• Users should expect to receive well-formatted, production-ready code snippets that adhere to the latest Next.js 13+ App Router conventions.

• Note that this skill requires a basic understanding of asynchronous JavaScript and the Web Fetch API standards, as it heavily relies on the native Request and Response objects.