Nuxt Server

What it does

This skill assists with Nuxt 4 server development, specifically focusing on building API routes, handling backend logic, and integrating server-side functionality within a Nuxt frontend project using Nitro. It provides guidance on structuring server files (like api, routes, middleware, plugins), understanding HTTP method suffixes (.get.ts, .post.ts, etc.), and working with request utilities for parameters, bodies, and headers. This skill enables AI agents to help developers build robust and feature-rich Nuxt applications.

When to use it

• Implementing complex API endpoints using the file-based routing system.
• Handling user authentication and managing server sessions.
• Working with cookies or custom HTTP headers in your backend logic.
• Building file upload functionality on the server side.
• Understanding the internal workings of Nitro, Nuxt's built-in server framework.

Key capabilities

• File-Based Routing: Creating API and non-API routes using a defined directory structure (server/api, server/routes).
• HTTP Method Handling: Defining route handlers for different HTTP methods (GET, POST, PUT, DELETE) using specific file suffixes.
• Request Utilities: Accessing URL parameters, query parameters, request bodies, and headers within server routes.
• Nitro Plugin Integration: Utilizing Nitro plugins for tasks like database initialization.
• Database Integration Patterns: Guidance on integrating Cloudflare D1 with Drizzle, setting up PostgreSQL connections, implementing migrations, and building efficient queries (requires referencing database-patterns.md).
• WebSocket Implementation: Provides patterns for real-time features using WebSockets and Durable Objects (requires referencing websocket-patterns.md).

Example prompts

• "Show me an example of a Nuxt server route to handle a POST request to /api/users."
• "How do I access the user ID from a route like /api/users/[id]?"
• "Generate code for a middleware function that checks for authentication headers in my Nuxt application."

Tips & gotchas

• This skill focuses specifically on server-side development within a Nuxt 4 project using Nitro. It does not cover general frontend UI development or broader JavaScript concepts.
• To effectively use this skill, familiarity with basic Node.js and TypeScript is helpful.
• Referencing the linked documentation (references/server.md, references/database-patterns.md, references/websocket-patterns.md) will provide more in-depth information on specific topics.