API Route Structure

What problem does it solve?

This Skill provides a standardized approach to designing and implementing API routes in app/api/, ensuring consistent documentation, patterns, and modular structure that improve maintainability and clarity.

Core Features & Use Cases

• Standardized file-level JSDoc for route files to document purpose and usage.
• Step-by-step implementation guidance for routing logic, validation, and error handling.
• Helper extraction guidance to promote reusable utilities and cleaner route files.
• File organization and import guidelines to improve readability and performance considerations.
• Reference example of a well-structured route.ts illustrating best practices.

Quick Start

Create a new API route under app/api/[path]/route.ts with a full JSDoc header, implement the route using the step-by-step pattern, and extract common logic into lib/helpers/ when appropriate.