nextjs-vercel-typescript-cursorrules-prompt-file

To extend the provided rules to include usage of the ai-sdk-rsc library and integrate it with Vercel middleware and a KV database, here's an updated set of instructions tailored for use with Cursor IDE. These instructions are designed to help you effectively implement generative user interfaces using React Server Components (RSC) with the AI SDK.

Extended Rules for AI SDK RSC Integration with Vercel Middleware and KV Database

Environment and Tools

• You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, Radix UI, Tailwind, and Vercel middleware.
• You are familiar with Vercel's KV database for managing stateful data.

Code Style and Structure

• Write concise, technical TypeScript code with accurate examples.
• Use functional and declarative programming patterns; avoid classes.
• Prefer iteration and modularization over code duplication.
• Use descriptive variable names with auxiliary verbs (e.g., isLoading, hasError).
• Structure files: exported component, subcomponents, helpers, static content, types.

Naming Conventions

• Use lowercase with dashes for directories (e.g., components/auth-wizard).
• Favor named exports for components.

TypeScript Usage

• Use TypeScript for all code; prefer interfaces over types.
• Avoid enums; use maps instead.
• Use functional components with TypeScript interfaces.

Syntax and Formatting

• Use the function keyword for pure functions.
• Avoid unnecessary curly braces in conditionals; use concise syntax for simple statements.
• Use declarative JSX.

UI and Styling

• Use Shadcn UI, Radix UI, and Tailwind for components and styling.
• Implement responsive design with Tailwind CSS; use a mobile-first approach.

Performance Optimization

• Minimize use client, useEffect, and setState; favor React Server Components (RSC).
• Wrap client components in Suspense with fallback.
• Use dynamic loading for non-critical components.
• Optimize images: use WebP format, include size data, implement lazy loading.

Key Conventions

• Use nuqs for URL search parameter state management.
• Optimize Web Vitals (LCP, CLS, FID).
• Limit use client:
  • Favor server components and Next.js SSR.
  • Use only for Web API access in small components.
  • Avoid for data fetching or state management.
• Follow Next.js docs for Data Fetching, Rendering, and Routing.

AI SDK RSC Integration

• Setup and Installation: Integrate ai-sdk-rsc into your Next.js project.

  • Install the library using npm install ai-sdk-rsc or yarn add ai-sdk-rsc.
  • Configure middleware in middleware.ts to manage requests and sessions using Vercel's KV database.

• Middleware Implementation: Use Vercel middleware to handle incoming requests.

  • Create a middleware file in the middleware directory (e.g., middleware/ai-middleware.ts).
  • Use middleware to parse user input and manage sessions with the KV database.
  • Example:

    import { NextRequest, NextResponse } from 'next/server';
    import { kv } from '@vercel/kv';
    
    export async function middleware(req: NextRequest) {
      const sessionId = req.cookies.get('session-id');
      if (!sessionId) {
        const newSessionId = generateSessionId();
        await kv.set(newSessionId, { state: {} }); // Initialize state in KV database
        const res = NextResponse.next();
        res.cookies.set('session-id', newSessionId);
        return res;
      }
      // Fetch state from KV database
      const state = await kv.get(sessionId);
      req.nextUrl.searchParams.set('state', JSON.stringify(state));
      return NextResponse.next();
    }
    
    function generateSessionId() {
      return Math.random().toString(36).substring(2);
    }
    

• React Server Components (RSC) and AI SDK:

  • Use ai-sdk-rsc hooks to manage state and stream generative content.
  • Example usage of AI SDK hooks in a React Server Component:

    import { useAIStream } from 'ai-sdk-rsc';
    import { FC } from 'react';
    
    interface ChatProps {
      initialMessage: string;
    }
    
    const Chat: FC = ({ initialMessage }) => {
      const { messages, sendMessage } = useAIStream({
        initialMessage,
        onMessage: (message) => console.log('New message:', message),
      });
    
      return (
        {msg.content}
      );
    
    export default Chat;