Does this skill support built-in Nuxt validation functions?

No, this skill explicitly enforces the use of custom validation helpers from server/utils/bodyValidation.ts for more granular control and consistent error responses.

How is authentication handled in these patterns?

Endpoints use the requireUserSession helper to verify identity, automatically throwing 401 Unauthorized errors if a valid session is not found.

Are success responses wrapped in a standard object?

No, the pattern dictates returning data directly to keep the API clean and reduce unnecessary nesting in the response payload.

Why does the skill require using the ~~ alias for imports?

The ~~ alias is used to ensure reliable path resolution within the Nitro server environment, avoiding common directory mapping issues associated with the ~ alias.

How does it handle database access within routes?

It follows a strict separation of concerns where database logic must be placed in /server/database/queries/ rather than using database clients directly in the API route.

Nuxt API Route Patterns

Name: Nuxt API Route Patterns
Author: JosephAnson

byJosephAnson

0•

API Development

Standardizes the creation and modification of Nuxt server routes using Zod validation and specialized database query patterns.

This skill provides a structured framework for building robust API routes within Nuxt-based applications. It enforces essential architectural best practices, such as strict separation of concerns by isolating database logic into dedicated query files, implementing mandatory authentication through session helpers, and utilizing custom Zod-based validation for request bodies, parameters, and queries. By providing standardized patterns for CRUD operations and error handling, it ensures consistency across the backend while preventing common architectural pitfalls like direct database access in route handlers or improper server-side path resolution.

Key Features

01Implements consistent error handling and HTTP status code patterns for CRUD operations.

02Ensures correct server-side path resolution using Nuxt-specific aliases.

03Provides standardized Zod validation patterns for request bodies, parameters, and query strings.

04Streamlines authentication workflows using mandatory session-based user checks.

050 GitHub stars

06Enforces separation of concerns by decoupling database queries from API route handlers.

Use Cases

01Refactoring existing API routes to follow consistent validation and error-handling standards.

02Developing new authenticated API endpoints for a Nuxt-based backend service.

03Implementing complex CRUD operations with proper Row Level Security and database query separation.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add josephanson/claude-plugin api-patterns

For use in Claude.ai and ChatGPT

Download Skill