NEW

Next.js TypeScript Clerk Stripe Vercel Setup .cursorrules prompt file

{
"project": {
"language": "typescript",
"framework": "nextjs app router",
"rules": [
{
"description": "Ensure TypeScript is used without 'any' type.",
"codeQuality": "enforce_strict_typing"
},
{
"description": "Implement authentication and authorization using Clerk with RBAC.",
"authentication": {
"provider": "clerk",
"roles": {
"admin": "access_all_features_manage_tenants_detailers_clients_assessments",
"detailer": "read_services_pricing_assessments_manage_appointments_clients_take_payments",
"client": "access_assessments_schedule_appointments_communicate_provide_payments"
}
}
},
{
"description": "Style the application using Tailwind CSS with utility-first approach.",
"styling": "tailwind_usage"
},
{
"description": "Use ShadCN-UI for reusable UI components.",
"ui": "shadcn_ui_components"
},
{
"description": "Incorporate ShadCN-Graphs for visual graph representation.",
"visualization": "shadcn_graphs"
},
{
"description": "Integrate Ollama for deep learning models.",
"ai": "ollama_integration"
},
{
"description": "Use Convex for database, file storage, and AI vector search functionalities.",
"database": "convex_database"
},
{
"description": "Host the application on Vercel for scalability and sub-domain management.",
"hosting": "vercel_hosting"
},
{
"description": "Integrate Google Calendar for AI-powered appointment scheduling.",
"calendar_integration": "google_calendar_ai"
},
{
"description": "Utilize Google Chat for real-time customer support.",
"communication": "google_chat_integration"
},
{
"description": "Use Stripe for processing payments in the application.",
"payment": "stripe_integration"
},
{
"description": "Support self-marketing with tenant-specific QR codes.",
"marketing": "self_marketing_qr_code"
},
{
"description": "Enable client self-assessment for vehicle information capture.",
"feature": "client_self_assessment"
},
{
"description": "Ensure the application is invite-only for client entry.",
"security": "invite_only_app"
},
{
"description": "Generate estimates based on client assessment and detailer's pricing models.",
"feature": "estimate_generation"
},
{
"description": "Implement robust RBAC with Clerk for resource authorization based on role.",
"security": "role_based_access_control"
},
{
"description": "Employ a multi-tenant database architecture using MongoDB.",
"architecture": "mongo_db_multi_tenant"
},
{
"description": "Support dynamic pricing models for various detailers.",
"feature": "dynamic_pricing_models"
},
{
"description": "Provide an analytics dashboard for business insights.",
"analytics": "dashboard"
},
{
"description": "Allow customizable theming for client personalization.",
"ui": "customizable_theming"
},
{
"description": "Optimize developer experience with ESLint, Prettier, and EditorConfig.",
"codeQuality": "optimized_developer_experience"
},
{
"description": "Manage subscription cancellations and updates efficiently.",
"feature": "subscription_management"
},
{
"description": "Provide a dedicated dashboard for detailers to manage services and bookings.",
"feature": "detailer_dashboard"
},
{
"description": "Implement a rating and review system for client feedback on detailers.",
"feature": "rating_review_system"
},
{
"description": "Send automated reminders for upcoming appointments to users.",
"feature": "automated_reminders"
},
{
"description": "Implement a notification system for updates on bookings and services.",
"feature": "notification_system"
},
{
"description": "Include a comprehensive knowledge base for user guides and tutorials.",
"feature": "knowledge_base"
},
{
"description": "Implement client self-assessment enhancements with image/video upload functionality.",
"feature": "image_video_upload"
},
{
"description": "Develop a feedback mechanism to gather user input for continuous improvement.",
"feature": "feedback_mechanism"
},
{
"description": "Design a scalable system capable of handling a minimum of 10,000 concurrent users.",
"scalability": "high_concurrency_support"
}
{
"description": "Incorporate ShadCN-Graphs for visual graph representation.",
"visualization": "shadcn_graphs"
},
{
"description": "Integrate Ollma for deep learning models.",
"ai": "ollma_integration"
},
{
"description": "Use Convex for database, file storage, and AI vector search functionalities.",
"database": "convex_database"
},
{
"description": "Host the application on Vercel for scalability and sub-domain management.",
"hosting": "vercel_hosting"
},
{
"description": "Integrate Google Calendar for AI-powered appointment scheduling.",
"calendar_integration": "google_calendar_ai"
},
{
"description": "Utilize Google Chat for real-time customer support.",
"communication": "google_chat_integration"
},
{
"description": "Use Stripe for processing payments in the application.",
"payment": "stripe_integration"
},
{
"description": "Support self-marketing with tenant-specific QR codes.",
"marketing": "self_marketing_qr_code"
},
{
"description": "Enable client self-assessment for vehicle information capture.",
"feature": "client_self_assessment"
},
{
"description": "Ensure the application is invite-only for client entry.",
"security": "invite_only_app"
},
{
"description": "Generate estimates based on client assessment and detailer's pricing models.",
"feature": "estimate_generation"
},
{
"description": "Implement robust RBAC with Clerk for resource authorization based on role.",
"security": "role_based_access_control"
},
{
"description": "Employ a multi-tenant database architecture using MongoDB.",
"architecture": "mongo_db_multi_tenant"
},
{
"description": "Support dynamic pricing models for various detailers.",
"feature": "dynamic_pricing_models"
},
{
"description": "Provide an analytics dashboard for business insights.",
"analytics": "dashboard"
},
{
"description": "Allow customizable theming for client personalization.",
"ui": "customizable_theming"
},
{
"description": "Optimize developer experience with ESLint, Prettier, and EditorConfig.",
"codeQuality": "optimized_developer_experience"
},
{
"description": "Manage subscription cancellations and updates efficiently.",
"feature": "subscription_management"
},
{
"description": "Provide a dedicated dashboard for detailers to manage services and bookings.",
"feature": "detailer_dashboard"
},
{
"description": "Implement a rating and review system for client feedback on detailers.",
"feature": "rating_review_system"
},
{
"description": "Send automated reminders for upcoming appointments to users.",
"feature": "automated_reminders"
},
{
"description": "Implement a notification system for updates on bookings and services.",
"feature": "notification_system"
},
{
"description": "Include a comprehensive knowledge base for user guides and tutorials.",
"feature": "knowledge_base"
};
]
}
}

stack:

Next.js TypeScript Clerk Stripe Vercel Setup .cursorrules prompt file

Big Daddy Bobs

NEW

Next.js Vercel Todo App .cursorrules prompt file

Project Instructions

Use the project specification and guidelines as you build the todo app.

Write the complete code for every step. Do not get lazy.

Your goal is to completely finish whatever the user asks for.

Overview

Todo app is a web app that allows you to manage your todos.

Tech Stack

Frontend: Next.js, Tailwind, Shadcn, Framer Motion
Backend: Postgres, Supabase, Drizzle ORM, Server Actions
Auth: Clerk
Payments: Stripe
Deployment: Vercel

Project Structure

General Structure

actions - Server actions
db - Database related actions
Other actions
app - Next.js app router
api - API routes
route - An example route (each of these are only if needed)
- _components - One-off components for the route
- layout.tsx - Layout for the route
- page.tsx - Page for the route
components - Shared components
ui - UI components
utilities - Utility components
db - Database
migrations - Database migrations (you never have to do anything in here)
queries - Database queries
schema - Database schemas
lib - Library code
hooks - Custom hooks
prompts - Prompt files
public - Static assets
types - Type definitions

Project Specific Structure

Rules

Follow these rules when building the project.

General Rules

Use @ to import anything from the project unless otherwise specified
Use kebab case for all files and folders unless otherwise specified

Env Rules

If you update environment variables, update the .env.example file
All environment variables should go in .env.local
Do not expose environment variables to the frontend
Use NEXT_PUBLIC_ prefix for environment variables that need to be accessed from the frontend
You may import environment variables in server actions and components by using process.env.VARIABLE_NAME

Type Rules

Follow these rules when working with types.

When importing types, use @/types
Name files like example-types.ts
All types should go in types
Make sure to export the types in types/index.ts
Prefer interfaces over type aliases
If referring to db types, use @/db/schema such as SelectTodo from todos-schema.ts

An example of a type:

types/actions-types.ts

export type ActionState`<T>` = {  isSuccess: boolean  message: string  data?: T}

And exporting it:

types/index.ts

export * from "./actions-types"

Frontend Rules

Follow these rules when working on the frontend.

It uses Next.js, Tailwind, Shadcn, and Framer Motion.

General Rules

Use lucide-react for icons

Components

Use divs instead of other html tags unless otherwise specified
Separate the main parts of a component's html with an extra blank line for visual spacing
Use actions, not queries, in the app
Always tag a component with either use server or use client at the top, including layouts and pages

Organization

All components be named using kebab case like example-component.tsx unless otherwise specified
Put components in /_components in the route if one-off components
Put components in /components from the root if shared components

Data Fetching

Fetch data in server components and pass down as props to client components such as initialTodos
Use server actions from /actions to mutate data

Server Components

Use "use server" at the top of the file
Implement Suspense for asynchronous data fetching
Use a separate fetcher component for data loading (see example below)

Example of a server page:

"use server"import { Suspense } from "react"import { SomeAction } from "@/actions/some-actions"import SomeComponent from "./_components/some-component"import SomeSkeleton from "./_components/some-skeleton"export default async function ExampleServerPage({  params}: {  params: { id: string }}) {  return (    `<Suspense fallback={<SomeSkeleton className="some-class" />`}>      `<SomeComponentFetcher id={params.id} />`    `</Suspense>`  )}async function SomeComponentFetcher({ id }: { id: string }) {  const { data } = await SomeAction(id)  return (    `<SomeComponent className="some-class" initialData={data || []} id={id} />`  )}

Example of a server component:

"use server"interface ExampleServerComponentProps {  // Your props here}export async function ExampleServerComponent({  props}: ExampleServerComponentProps) {  // Your code here}

Client Components

Use "use client" at the top of the file

Example of a client page:

"use client"export default function ExampleClientPage() {  // Your code here}

Example of a client component:

"use client"interface ExampleClientComponentProps {  // Your props here}export default function ExampleClientComponent({  props}: ExampleClientComponentProps) {  // Your code here}

Backend Rules

Follow these rules when working on the backend.

It uses Postgres, Supabase, Drizzle ORM, and Server Actions.

General Rules

Never generate migrations. You do not have to do anything in the db/migrations folder inluding migrations and metadata. Ignore it.

Organization

Schemas

When importing schemas, use @/db/schema
Name files like example-schema.ts
All schemas should go in db/schema
Make sure to export the schema in db/schema/index.ts
Make sure to add the schema to the schema object in db/db.ts
If using a userId, always use userId: text("user_id").notNull()
Always include createdAt and updatedAt columns in all tables
Make sure to cascade delete when necessary
Use enums for columns that have a limited set of possible values such as:

import { pgEnum } from "drizzle-orm/pg-core"export const membershipEnum = pgEnum("membership", ["free", "pro"])membership: membershipEnum("membership").notNull().default("free")

Example of a schema:

db/schema/todos-schema.ts

import { boolean, pgTable, text, timestamp, uuid } from "drizzle-orm/pg-core"export const todosTable = pgTable("todos", {  id: uuid("id").defaultRandom().primaryKey(),  userId: text("user_id").notNull(),  content: text("content").notNull(),  completed: boolean("completed").default(false).notNull(),  createdAt: timestamp("created_at").defaultNow().notNull(),  updatedAt: timestamp("updated_at")    .defaultNow()    .notNull()    .$onUpdate(() => new Date())})export type InsertTodo = typeof todosTable.$inferInsertexport type SelectTodo = typeof todosTable.$inferSelect

And exporting it:

db/schema/index.ts

export * from "./todos-schema"

And adding it to the schema in db/db.ts:

db/db.ts

import { todosTable } from "@/db/schema"const schema = {  todos: todosTable}

And a more complex schema:

import { pgTable, text, timestamp, uuid } from "drizzle-orm/pg-core"export const chatsTable = pgTable("chats", {  id: uuid("id").defaultRandom().primaryKey(),  userId: text("user_id").notNull(),  name: text("name").notNull(),  createdAt: timestamp("created_at").defaultNow().notNull(),  updatedAt: timestamp("updated_at")    .defaultNow()    .notNull()    .$onUpdate(() => new Date())})export type InsertChat = typeof chatsTable.$inferInsertexport type SelectChat = typeof chatsTable.$inferSelect

import { pgEnum, pgTable, text, timestamp, uuid } from "drizzle-orm/pg-core"import { chatsTable } from "./chats-schema"export const roleEnum = pgEnum("role", ["assistant", "user"])export const messagesTable = pgTable("messages", {  id: uuid("id").defaultRandom().primaryKey(),  chatId: uuid("chat_id")    .references(() => chatsTable.id, { onDelete: "cascade" })    .notNull(),  content: text("content").notNull(),  role: roleEnum("role").notNull(),  createdAt: timestamp("created_at").defaultNow().notNull(),  updatedAt: timestamp("updated_at")    .defaultNow()    .notNull()    .$onUpdate(() => new Date())})export type InsertMessage = typeof messagesTable.$inferInsertexport type SelectMessage = typeof messagesTable.$inferSelect

And exporting it:

db/schema/index.ts

export * from "./chats-schema"export * from "./messages-schema"

And adding it to the schema in db/db.ts:

db/db.ts

import { chatsTable, messagesTable } from "@/db/schema"const schema = {  chats: chatsTable,  messages: messagesTable}

Queries

When importing queries, use @/db/queries
Name files like example-queries.ts
All queries should go in db/queries
Queries have 'use server' at the top
Only write the needed queries
Do not use explicit returns in queries
Sort in CRUD order: Create, Read, Update, Delete

Example of a query:

db/queries/todos-queries.ts

"use server"import { db } from "@/db/db"import { InsertTodo, todosTable } from "@/db/schema"import { eq } from "drizzle-orm"export const createTodo = async (data: InsertTodo) => {  try {    const [newTodo] = await db.insert(todosTable).values(data).returning()    return newTodo  } catch (error) {    console.error("Error creating todo:", error)    throw new Error("Failed to create todo")  }}export const getTodos = async (userId: string) => {  try {    return db.query.todos.findMany({      where: eq(todosTable.userId, userId)    })  } catch (error) {    console.error("Error getting todos:", error)    throw new Error("Failed to get todos")  }}

Server Actions

When importing actions, use @/actions or @/actions/db if db related
DB related actions should go in the actions/db folder
Other actions should go in the actions folder
Name files like example-actions.ts
All actions should go in the actions folder
Always use revalidatePath("/") after a successful action
Only write the needed actions
Return an ActionState with the needed data type from actions
Include Action at the end of function names Ex: exampleFunction -> exampleFunctionAction
Actions should return a Promise<ActionState<T>>
Actions use queries from db/queries
Sort in CRUD order: Create, Read, Update, Delete

export type ActionState`<T>` = {  isSuccess: boolean  message: string  data?: T}

Example of an action:

actions/db/todos-actions.ts

"use server"import { createTodo, getTodos } from "@/db/queries/todos-queries"import { InsertTodo, SelectTodo } from "@/db/schema/todos-schema"import { ActionState } from "@/types"import { revalidatePath } from "next/cache"export async function createTodoAction(  todo: InsertTodo): Promise`<ActionState<SelectTodo>`> {  try {    const newTodo = await createTodo(todo)    revalidatePath("/")    return {      isSuccess: true,      message: "Todo created successfully",      data: newTodo    }  } catch (error) {    console.error("Error creating todo:", error)    return { isSuccess: false, message: "Failed to create todo" }  }}export async function getTodosAction(  userId: string): Promise`<ActionState<SelectTodo[]>`> {  try {    const todos = await getTodos(userId)    return {      isSuccess: true,      message: "Todos retrieved successfully",      data: todos    }  } catch (error) {    console.error("Error getting todos:", error)    return { isSuccess: false, message: "Failed to get todos" }  }}

Auth Rules

Follow these rules when working on auth.

It uses Clerk for authentication.

General Rules

Import the auth helper with import { auth } from "@clerk/nextjs/server" in server components

Payments Rules

Follow these rules when working on payments.

It uses Stripe for payments.

stack:

Next.js Vercel Todo App .cursorrules prompt file

Mckay Wrigley

NEW

Astro .cursorrules Cursor AI Three.js Tailwind CSS project prompt file

Project-specific Cursor rules for a portfolio website using Astro & Three.JS on jayciretose.github.io

key_conventions:

Follow Astro's style guide for consistent code formatting.
Use TypeScript for enhanced type safety and developer experience.
Use functional, declarative programming. Avoid classes.
Use descriptive variable names with auxiliary verbs (e.g., isLoading).
Use lowercase with dashes for directories (e.g., components/image-gallery).
Favor named exports for components.
Implement proper error handling and logging.

project_structure:

Use the recommended Astro project structure:
- src/
- components/
- layouts/
- pages/
- styles/
- public/
- astro.config.mjs

component_development:

Create .astro files for Astro components.
Use framework-specific components (React) when necessary.
Implement proper component composition and reusability.
Use Astro's component props for data passing.
Leverage Astro's built-in components like <Markdown /> when appropriate.

routing_and_pages:

Utilize Astro's file-based routing system in the src/pages/ directory.
Implement dynamic routes using [.slug].astro syntax.
Use getStaticPaths() for generating static pages with dynamic routes.
Implement proper 404 handling with a 404.astro page.

content_management:

Use Markdown (.md) or MDX (.mdx) files for content-heavy pages.
Leverage Astro's built-in support for frontmatter in Markdown files.
Implement content collections for organized content management.

styling:

Use Astro's scoped styling with <style> tags in .astro files.
Leverage global styles when necessary, importing them in layouts.
Utilize CSS preprocessing with Sass or Less if required.
Implement responsive design using CSS custom properties and media queries.
Integrate Tailwind CSS with Astro via @astrojs/tailwind.
Use Tailwind utility classes extensively in your Astro components.
Leverage Tailwind's responsive design utilities (sm:, md:, lg:, etc.).
Utilize Tailwind's color palette and spacing scale for consistency.
Implement custom theme extensions in tailwind.config.cjs when necessary.
Never use the @apply directive.

performance_optimization:

Minimize use of client-side JavaScript; leverage Astro's static generation.
Use the client:* directives judiciously for partial hydration:
- client:load for immediately needed interactivity
- client:idle for non-critical interactivity
- client:visible for components that should hydrate when visible
Implement proper lazy loading for images and other assets.
Utilize Astro's built-in asset optimization features.

data_fetching:

Use Astro.props for passing data to components.
Implement getStaticPaths() for fetching data at build time.
Use Astro.glob() for working with local files efficiently.
Implement proper error handling for data fetching operations.

seo_and_meta_tags:

Use Astro's <head> tag for adding meta information.
Implement canonical URLs for proper SEO.
Use the <SEO> component pattern for reusable SEO setups.

integrations_and_plugins:

Utilize Astro integrations for extending functionality (e.g., @astrojs/image).
Implement proper configuration for integrations in astro.config.mjs.
Use Astro's official integrations when available for better compatibility.

build_and_deployment:

Optimize the build process using Astro's build command.
Implement proper environment variable handling for different environments.
Use static hosting platforms compatible with Astro (Netlify, Vercel, etc.).
Implement proper CI/CD pipelines for automated builds and deployments.

three_js_integration:

Set up Three.js using React three fiber in relevant components.
Use efficient rendering techniques to handle complex 3D scenes.
Optimize 3D object loading and management using Three.js best practices.
Leverage Three.js libraries for additional capabilities (e.g., animations, interactions).

testing:

Implement unit tests for utility functions and helpers.
Use end-to-end testing tools like Cypress for testing the built site.
Implement visual regression testing if applicable.

accessibility:

Ensure proper semantic HTML structure in Astro components.
Implement ARIA attributes where necessary.
Ensure keyboard navigation support for interactive elements.

performance_metrics:

Prioritize Core Web Vitals (LCP, FID, CLS) in development.
Use Lighthouse and WebPageTest for performance auditing.
Implement performance budgets and monitoring.

stack:

Astro .cursorrules Cursor AI Three.js Tailwind CSS project prompt file

Jay Ciretose

NEW

SvelteKit Supabase Tailwind .cursorrules prompt file

File Path Usage

IMPORTANT: Always use full file paths when referencing, editing, or creating files.

Example: E:\Stojanovic-One\src\routes\Home.svelte

This rule applies to all file operations and must be followed consistently.

You are an AI assistant for the Stojanovic-One web application project. Adhere to these guidelines:
Please this is utterly important provide full file paths for each file you edit, create or delete.
Always provide it in a format like this: edit this file now: E:\Stojanovic-One\src\routes\Home.svelte or create this file in this path: E:\Stojanovic-One\src\routes\Home.svelte
Also always provide file paths as outlined in @AI.MD like if you say lets update this file or lets create this file always provide the paths.

Tech Stack:

Frontend & Backend: SvelteKit
Database: PostgreSQL (via Supabase)
UI Styling: Tailwind CSS
Deployment: Vercel
Authentication: Supabase Auth

Follow Elon Musk's Algorithm for Efficiency:
a. Question every requirement critically
b. Delete unnecessary parts
c. Simplify and optimize remaining components
d. Accelerate cycle time
e. Automate as the final step
Practice Test-Driven Development (TDD):

Write failing tests first
Implement minimum code to pass tests
Refactor while maintaining passing tests

File Management:

Include full file path as a comment at the start of each file
Update project structure in AI.MD when adding new files/directories
Maintain up-to-date package.json

Testing:

Use Vitest for unit and integration tests
Aim for high test coverage (80% or higher)

Code Quality:

Prioritize readability and maintainability
Implement comprehensive error handling
Use TypeScript for type safety

Documentation:

Write clear comments and use JSDoc when appropriate
Keep README.md and AI.MD updated
Maintain CHANGELOG.md for significant changes

Truthfulness and Clarity:

Provide accurate, thoughtful answers
Admit when you don't know something
Be concise while ensuring clarity

Development Workflow:

Question and refine requirements
Break down tasks into small, manageable issues
For each task:
a. Write failing tests
b. Implement minimum code to pass tests
c. Refactor and optimize
Conduct self-review before suggesting merges
Ensure CI passes before finalizing changes

Best Practices:
- Follow RESTful API design principles when applicable
- Implement responsive design for components
- Use Zod for data validation
- Regularly update dependencies and check for vulnerabilities
Continuous Improvement:
- Suggest process improvements when applicable
- Look for opportunities to simplify and optimize code and workflows
Windows Compatibility:
- Provide PowerShell commands for Windows users
- Avoid Unix-specific commands (e.g., use Remove-Item instead of rm)
- Use cross-platform Node.js commands when possible

Always refer to AI.MD for detailed project-specific guidelines and up-to-date practices. Continuously apply Elon Musk's efficiency principles throughout the development process.

Design and User Experience:
- Implement dark mode compatibility
- Ensure mobile-friendly and responsive design
- Optimize for performance
- Create modern and beautiful UI
- Consider accessibility in all design decisions

stack:

SvelteKit Supabase Tailwind .cursorrules prompt file

Djordje Stojanovic

NEW

React NextJS UI development .cursorrules prompt file

You are an expert AI programming assistant that primarily focuses on producing clear, readable JavaScript code for the browser.

You also use the latest versions of popular frameworks and libraries such as React & NextJS (with app router).

You provide accurate, factual, thoughtful answers, and are a genius at reasoning.

- This project uses Next.js App Router never suggest using the pages router or provide code using the pages router.
- Follow the user's requirements carefully & to the letter.
- First think step-by-step - describe your plan for what to build in pseudocode, written out in great detail.
- Confirm, then write code!
- Always write correct, up to date, bug free, fully functional and working, secure, performant and efficient code.
- Focus on readability over being performant.
- Fully implement all requested functionality.
- Leave NO todo's, placeholders or missing pieces.
- Be sure to reference file names.
- Be concise. Minimize any other prose.
- If you think there might not be a correct answer, you say so. If you do not know the answer, say so instead of guessing.
- Only write code that is neccessary to complete the task.
- Rewrite the complete code only if necessary.
- This is app is hosted on Vercel as well as Replit. Make sure your code is compatible with both!

stack:

React NextJS UI development .cursorrules prompt file

Austin Thesing

NEW

JavaScript Astro Tailwind CSS .cursorrules prompt file

You are an expert in JavaScript, TypeScript, and Astro framework for scalable web development.

Key Principles - Write concise, technical responses with accurate Astro examples. - Leverage Astro's partial hydration and multi-framework support effectively. - Prioritize static generation and minimal JavaScript for optimal performance. - Use descriptive variable names and follow Astro's naming conventions. - Organize files using Astro's file-based routing system.

Astro Project Structure - Use the recommended Astro project structure: - src/ - components/ - layouts/ - pages/ - styles/ - public/ - astro.config.mjs

Component Development - Create .astro files for Astro components. - Use framework-specific components (React, Vue, Svelte) when necessary. - Implement proper component composition and reusability. - Use Astro's component props for data passing. - Leverage Astro's built-in components like when appropriate.

Routing and Pages - Utilize Astro's file-based routing system in the src/pages/ directory. - Implement dynamic routes using [...slug].astro syntax. - Use getStaticPaths() for generating static pages with dynamic routes. - Implement proper 404 handling with a 404.astro page.

Content Management - Use Markdown (.md) or MDX (.mdx) files for content-heavy pages. - Leverage Astro's built-in support for frontmatter in Markdown files. - Implement content collections for organized content management.

Styling - Use Astro's scoped styling with tags in .astro files. - Leverage global styles when necessary, importing them in layouts. - Utilize CSS preprocessing with Sass or Less if required. - Implement responsive design using CSS custom properties and media queries.Performance Optimization - Minimize use of client-side JavaScript; leverage Astro's static generation. - Use the client:* directives judiciously for partial hydration: - client:load for immediately needed interactivity - client:idle for non-critical interactivity - client:visible for components that should hydrate when visible - Implement proper lazy loading for images and other assets. - Utilize Astro's built-in asset optimization features.Data Fetching - Use Astro.props for passing data to components. - Implement getStaticPaths() for fetching data at build time. - Use Astro.glob() for working with local files efficiently. - Implement proper error handling for data fetching operations.SEO and Meta Tags - Use Astro's <head> tag for adding meta information. - Implement canonical URLs for proper SEO. - Use the <SEO> component pattern for reusable SEO setups.Integrations and Plugins - Utilize Astro integrations for extending functionality (e.g., @astrojs/image). - Implement proper configuration for integrations in astro.config.mjs. - Use Astro's official integrations when available for better compatibility.Build and Deployment - Optimize the build process using Astro's build command. - Implement proper environment variable handling for different environments. - Use static hosting platforms compatible with Astro (Netlify, Vercel, etc.). - Implement proper CI/CD pipelines for automated builds and deployments.Styling with Tailwind CSS - Integrate Tailwind CSS with Astro @astrojs/tailwindTailwind CSS Best Practices - Use Tailwind utility classes extensively in your Astro components. - Leverage Tailwind's responsive design utilities (sm:, md:, lg:, etc.). - Utilize Tailwind's color palette and spacing scale for consistency. - Implement custom theme extensions in tailwind.config.cjs when necessary. - Never use the @apply directiveTesting - Implement unit tests for utility functions and helpers. - Use end-to-end testing tools like Cypress for testing the built site. - Implement visual regression testing if applicable.Accessibility - Ensure proper semantic HTML structure in Astro components. - Implement ARIA attributes where necessary. - Ensure keyboard navigation support for interactive elements.Key Conventions 1. Follow Astro's Style Guide for consistent code formatting. 2. Use TypeScript for enhanced type safety and developer experience. 3. Implement proper error handling and logging. 4. Leverage Astro's RSS feed generation for content-heavy sites. 5. Use Astro's Image component for optimized image delivery.Performance Metrics - Prioritize Core Web Vitals (LCP, FID, CLS) in development. - Use Lighthouse and WebPageTest for performance auditing. - Implement performance budgets and monitoring.Refer to Astro's official documentation for detailed information on components, routing, and integrations for best practices.

stack:

JavaScript Astro Tailwind CSS .cursorrules prompt file

Arun Sathiya

NEW

SvelteKit RESTful API Tailwind CSS .cursorrules prompt file

# File Path Usage

# IMPORTANT: Always use full file paths when referencing, editing, or creating files.

# Example: E:\Stojanovic-One\src\routes\Home.svelte

# This rule applies to all file operations and must be followed consistently.

1. Tech Stack:

  - Frontend & Backend: SvelteKit
  - Database: PostgreSQL (via Supabase)
  - UI Styling: Tailwind CSS
  - Deployment: Vercel
  - Authentication: Supabase Auth

2. Follow Elon Musk's Algorithm for Efficiency:
  a. Question every requirement critically
  b. Delete unnecessary parts
  c. Simplify and optimize remaining components
  d. Accelerate cycle time
  e. Automate as the final step

3. Practice Test-Driven Development (TDD):

  - Write failing tests first
  - Implement minimum code to pass tests
  - Refactor while maintaining passing tests

4. File Management:

  - Include full file path as a comment at the start of each file
  - Update project structure in AI.MD when adding new files/directories
  - Maintain up-to-date package.json

5. Testing:

- Use Vitest for unit and integration tests
- Aim for high test coverage (80% or higher)

6. Code Quality:

  - Prioritize readability and maintainability
  - Implement comprehensive error handling
  - Use TypeScript for type safety

7. Documentation:

  - Write clear comments and use JSDoc when appropriate
  - Keep README.md and AI.MD updated
  - Maintain CHANGELOG.md for significant changes

8. Truthfulness and Clarity:

  - Provide accurate, thoughtful answers
  - Admit when you don't know something
  - Be concise while ensuring clarity

9. Development Workflow:

  - Question and refine requirements
  - Break down tasks into small, manageable issues
  - For each task:
   a. Write failing tests
   b. Implement minimum code to pass tests
   c. Refactor and optimize
  - Conduct self-review before suggesting merges
  - Ensure CI passes before finalizing changes

10. Best Practices:

  - Follow RESTful API design principles when applicable
  - Implement responsive design for components
  - Use Zod for data validation
  - Regularly update dependencies and check for vulnerabilities

11. Continuous Improvement:

- Suggest process improvements when applicable
- Look for opportunities to simplify and optimize code and workflows

12. Windows Compatibility:
  - Provide PowerShell commands for Windows users
  - Avoid Unix-specific commands (e.g., use `Remove-Item` instead of `rm`)
  - Use cross-platform Node.js commands when possible

Always refer to AI.MD for detailed project-specific guidelines and up-to-date practices. Continuously apply Elon Musk's efficiency principles throughout the development process.

13. Design and User Experience:
  - Implement dark mode compatibility
  - Ensure mobile-friendly and responsive design
  - Optimize for performance
  - Create modern and beautiful UI
  - Consider accessibility in all design decisions

stack:

SvelteKit RESTful API Tailwind CSS .cursorrules prompt file

Djordje Stojanovic

NEW

Next.js 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:
  ```typescript
  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:
  ```typescript
  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 (

{messages.map((msg, index) => (

{msg.content}

))}
 <button onClick={() => sendMessage('Hello AI!')}>Send Message

);
};

export default Chat;
```

- **KV Database Integration**:
- Use Vercel's KV database to store and retrieve session data.
- Utilize `kv.set`, `kv.get`, and `kv.delete` to manage data.
- Ensure the database operations are asynchronous to avoid blocking server-side rendering (SSR).

- **Data Fetching and State Management**:
- Use Next.js data fetching methods (`getServerSideProps`, `getStaticProps`) to manage server-side state.
- Avoid client-side data fetching methods (`useEffect`, `fetch`) except for critical, non-blocking operations.

- **Deployment Considerations**:
- Ensure all environment variables (e.g., API keys, database credentials) are securely stored in Vercel's environment settings.
- Configure Vercel's KV and other serverless functions correctly to handle scalability and performance needs.

By following these extended rules, you'll be able to create a well-optimized, scalable, and efficient Next.js application that leverages `ai-sdk-rsc`, Vercel middleware, and KV database for building sophisticated AI-driven interfaces.

stack: