Awesome Cursor Rules

Cursor Project Rules enhance Cursor AI editor behavior with project-specific guidance and reusable coding standards.

Cursor AI is an AI-powered code editor. Cursor Project Rules are Markdown-based .mdc files that live in .cursor/rules/ and tell Cursor how to behave for specific projects, file types, frameworks, and workflows.

Sponsorships

coderabbit.ai - Cut Code Review Time & Bugs in Half. Instantly.

Unblocked MCP- Supercharge Cursor with your team’s knowledge

Warp - Built for coding with multiple AI agents

Contents

• Why Cursor Rules
• Rules
  • Frontend Frameworks and Libraries
  • Backend and Full-Stack
  • Mobile Development
  • Games and Graphics
  • CSS and Styling
  • State Management
  • Database and API
  • Testing
  • Hosting and Deployments
  • Build Tools and Development
  • Language-Specific
  • Security
  • Documentation
• Directories
• How to Use

Why Cursor Rules

Cursor rules help developers define project-specific instructions for Cursor AI. This repository uses the modern .mdc Project Rules format.

Customized behavior means Cursor can respond to the specific needs of a project instead of relying only on general coding knowledge. Rules can describe local architecture, preferred libraries, common methods, domain constraints, and other context that makes generated code more relevant.

Consistency is the other big win. By defining coding standards and best practices in .mdc files, teams can guide Cursor toward code that matches the project's style, naming, structure, and review expectations.

Project rules also reduce repeated manual editing. Well-scoped rules give Cursor reusable project knowledge up front, so suggestions are more likely to fit the codebase on the first pass and less likely to need the same corrections again.

For teams, shared .cursor/rules/*.mdc files keep AI assistance aligned across contributors. Everyone can work from the same project-specific guidance, whether the rule covers framework usage, security requirements, testing conventions, or workflow details.

By adding selected .mdc files to .cursor/rules/, you can use these rules directly in your project.

Rules

Frontend Frameworks and Libraries

• Angular (Novo Elements) - Angular development with Novo Elements UI library.
• Angular (TypeScript) - Angular development with TypeScript integration.
• Astro (TypeScript) - Astro development with TypeScript integration.
• Beefree SDK (TypeScript, JavaScript, CSS, HTML, React, Angular, Vue) - Embedding Beefree SDK's no-code content editors (for emails, pages, and popups) into a web application.
• Cursor AI (React, TypeScript, shadcn/ui) - Cursor AI development with React, TypeScript, and shadcn/ui integration.
• Next.js 15 (React 19, Vercel AI, Tailwind) - Next.js development with React 19, Vercel AI, and Tailwind CSS integration.
• Next.js 15 (Supabase, TypeScript, Security) - 27 architecture rules preventing AI hallucinations: insecure auth (getSession vs getUser), synchronous params, deprecated imports, missing RLS, and Stripe key exposure. Built for Cursor Agent and Claude Code.
• Next.js 14 (Tailwind, SEO) - Next.js development with Tailwind CSS and SEO optimization.
• Next.js (React, Tailwind) - Next.js development with React and Tailwind CSS integration.
• Next.js (React, TypeScript) - Next.js development with React and TypeScript integration.
• Next.js (SEO Development) - Next.js development with SEO optimization.
• Next.js (Supabase Todo App) - Next.js development with Supabase integration for a Todo app.
• Next.js (TanStack Query v5) - Next.js App Router with TanStack Query v5, covering the HydrationBoundary pattern, Server Actions as mutations, and optimistic updates.
• Next.js (Type LLM) - Next.js development with Type LLM integration.
• Next.js (Tailwind, TypeScript) - Next.js development with Tailwind CSS and TypeScript integration.
• Next.js (TypeScript App) - Next.js development with TypeScript integration.
• Next.js (TypeScript) - Next.js development with TypeScript integration.
• Next.js (TypeScript, Tailwind) - Next.js development with TypeScript and Tailwind CSS integration.
• Next.js (Vercel, Supabase) - Next.js development with Vercel and Supabase integration.
• Next.js (Vercel, TypeScript) - Next.js development with Vercel and TypeScript integration.
• Next.js (App Router) - Next.js development with App Router integration.
• Next.js (Material UI, Tailwind CSS) - Next.js development with Material UI and Tailwind CSS integration.
• Qwik (Basic Setup with TypeScript and Vite) - Qwik development with TypeScript and Vite integration.
• Qwik (with Tailwind CSS) - Qwik development with Tailwind CSS integration.
• React Components Creation - React component creation and development.
• React (FormEngine AI Form Builder) - Generating React forms from screenshots, PDFs, HTML, or text descriptions with validated FormEngine JSON schema. Renders through RSuite, Material UI, or Mantine.
• React (Next.js UI Development) - React development with Next.js UI integration.
• React Router v7 - Framework mode, data routers, loaders, actions, route modules, and progressive enhancement.
• React (TypeScript, Next.js, Node.js) - React development with TypeScript, Next.js, and Node.js integration.
• React (TypeScript, Symfony) - React development with TypeScript and Symfony integration.
• Semiotic (React, D3, Data Visualization) - Semiotic data visualization library with 30+ chart types, MCP server, and AI-assisted chart generation.
• Shopify Theme (Liquid, JavaScript, CSS) - Shopify theme development with Liquid templates, section schemas, frontend assets, performance, and accessibility.
• Solid.js (Basic Setup) - Solid.js development with basic setup.
• Solid.js (TypeScript) - Solid.js development with TypeScript integration.
• Solid.js (Tailwind CSS) - Solid.js development with Tailwind CSS integration.
• Svelte 5 vs Svelte 4 - Comparing Svelte 5 and Svelte 4 development.
• SvelteKit (RESTful API, Tailwind CSS) - SvelteKit development with RESTful API and Tailwind CSS integration.
• SvelteKit (Tailwind CSS, TypeScript) - SvelteKit development with Tailwind CSS and TypeScript integration.
• SvelteKit (TypeScript Guide) - SvelteKit development with TypeScript integration.
• TanStack Router (React) - TanStack Router v1 with file-based routing, typed params, search validation, loaders, auth guards, and route preloading.
• Vue 3 (Nuxt 3 Development) - Vue 3 development with Nuxt 3 integration.
• Vue 3 (Nuxt 3, TypeScript) - Vue 3 development with TypeScript integration.
• Vue 3 (Composition API) - Vue 3 development with Composition API integration.
• Vue/Nuxt Full AI Stack - Complete AI coding setup for Vue 3 & Nuxt 3 with Cursor Project Rules, CLAUDE.md, Copilot instructions, and generation skills.

Backend and Full-Stack

• Cloudflare Workers (Hono, Angular) - Full-stack SaaS applications on Cloudflare Workers with Hono APIs, Angular frontends, typed RPC, D1/Neon, and production observability.
• Convex Best Practices - Convex development with best practices.
• Deno Integration - Deno development with integration techniques.
• Drupal 11 - Modern CMS development.
• Elixir Engineer Guidelines - Elixir development with engineer guidelines.
• Elixir (Phoenix, Docker) - Elixir development with Phoenix and Docker integration.
• ES Module (Node.js) - ES Module development with Node.js guidelines.
• Go Backend Scalability - Go development with backend scalability.
• Go ServeMux REST API - Go development with ServeMux REST API integration.
• Go (Basic Setup) - Go development with basic setup.
• Go with Fiber - Go development with Fiber integration.
• Go Temporal DSL - Go development with Temporal DSL integration.
• Google ADK - Google Agent Development Kit agents, tools, sessions, memory, artifacts, evaluation, and deployment.
• HOL (Hedera TypeScript SDK) - Hashgraph Online development with TypeScript, building AI agents on Hedera with RegistryBrokerClient.
• HTMX (Basic Setup) - HTMX development with basic setup.
• HTMX (Flask) - HTMX development with Flask integration.
• HTMX (Django) - HTMX development with Django integration.
• Java (Spring Boot, JPA) - Java development with Spring Boot and JPA integration.
• Knative (Istio, Typesense, GPU) - Knative development with Istio, Typesense, and GPU integration.
• Kotlin Ktor Development - Kotlin development with Ktor integration.
• Laravel (PHP 8.3) - Laravel development with PHP 8.3 integration.
• Laravel (TALL Stack) - Laravel development with TALL Stack best practices.
• Manifest - YAML-based configuration and metadata files.
• Momen.app (Backend-as-a-Service) - Building custom frontends with Momen.app as headless BaaS with GraphQL API, actionflows, AI agents, and Stripe integration.
• Node.js (MongoDB) - Node.js development with MongoDB integration.
• Node.js (MongoDB, JWT, Express, React) - Node.js development with MongoDB, JWT, Express, and React integration.
• Rails 8 (Basic Setup) - Rails development with basic setup.
• Python (FastAPI) - Python FastAPI backend development and best practices.
• Python 3.12 (FastAPI Best Practices) - Python FastAPI development with best practices.
• Python (Django Best Practices) - Python Django development with best practices.
• Python (FastAPI Best Practices) - Python FastAPI development with best practices.
• Python (FastAPI Scalable API) - Python FastAPI development with scalable API integration.
• Python (FastAPI Production Architecture) - FastAPI services with router/service/repository boundaries, typed provider adapters, bulkhead isolation, idempotency, and domain exceptions.
• Python (Flask JSON Guide) - Python Flask development with JSON guide.
• Python LLM & ML Workflow - Python LLM & ML development with workflow integration.
• Salesforce (Apex) - Salesforce development with Apex integration.
• TanStack Start - Full-stack React framework including server functions, API routes, streaming with defer(), SSR, and multi-platform deployment.
• TypeScript (NestJS Anti-Hallucination) - Rules that block deprecated, phantom, or incorrect NestJS imports, decorators, providers, modules, and testing patterns.
• TypeScript (NestJS Best Practices) - TypeScript development with NestJS best practices.
• TYPO3 CMS Extension - TYPO3 CMS development with extension integration.
• WordPress (PHP, Guzzle, Gutenberg) - WordPress development with PHP, Guzzle, and Gutenberg integration.
• WordPress (macOS) - WordPress development on macOS.
• WordPress Full AI Stack - Complete AI coding setup for WordPress — themes, plugins, Gutenberg, WooCommerce, ACF, REST API with Cursor Project Rules, CLAUDE.md, Copilot instructions, and 5 generation skills.

Mobile Development

• Android Native (Jetpack Compose) - Android development with Jetpack Compose integration.
• Cursor Rules Pack v2 - 7 sample production-tested rules (dependency discipline, error handling, state management, webhook security, and more). See the pack README for full-pack details.
• Flutter Expert - Flutter development with expert integration.
• HarmonyOS ArkTS - Components, state, resources, lifecycle, layout, and accessibility.
• NativeScript - Cross-platform mobile app development.
• React Native Expo - Expo-based mobile app development.
• SwiftUI Guidelines - SwiftUI development guidelines.
• TypeScript (Expo, Jest, Detox) - TypeScript development with Expo, Jest, and Detox integration.
• UIKit Guidelines - UIKit development guidelines.

Games and Graphics

• ASCII Simulation Game - Text-based simulation game development.
• Blender Python Add-ons - Operators, panels, properties, registration, and API-safe scripting.
• DragonRuby Best Practices - DragonRuby development with best practices integration.
• GameMaker GML - GameMaker Language projects, objects, events, rooms, data structures, and performance-minded gameplay code.
• Graphical Apps Development - Interactive visual application development.
• Unity (C#) - Unity development with C# integration.

CSS and Styling

• Landing Page Image Quality - Avoiding placeholder or broken image URLs, using stable visual assets, and checking alt text, dimensions, licensing, and responsive behavior.
• Tailwind CSS (Next.js Guide) - Tailwind CSS development with Next.js integration.
• Tailwind (React, Firebase) - Tailwind development with React and Firebase integration.
• Tailwind (shadcn/ui Integration) - Tailwind development with shadcn/ui integration.
• HTML (Tailwind CSS, JavaScript) - HTML development with Tailwind CSS and JavaScript integration.
• JavaScript (Astro, Tailwind CSS) - JavaScript development with Astro and Tailwind CSS integration.
• React (Styled Components) - React development with Styled Components integration.
• React (Chakra UI) - React development with Chakra UI integration.
• RTL / Right-to-Left (i18n, Tailwind, React Native) - RTL development with logical CSS properties, Tailwind logical classes, bidirectional text, and automated auditing via rtlify-ai.
• Toss-Style Design System - Disciplined product UI with restrained color, grayscale hierarchy, typography, cards, metrics, dark mode, and accessibility.

State Management

• React (Redux, TypeScript) - React development with Redux and TypeScript integration.
• React (MobX) - React development with MobX integration.
• React (React Query) - React development with React Query integration.
• React (TanStack Router + Query) - React SPAs combining TanStack Router v1 and TanStack Query v5 for zero-loading-spinner routing and type-safe server state.
• TanStack Query v5 - Query options, query key factories, mutations, optimistic updates, infinite queries, Suspense, and prefetching.

Database and API

• GraphQL (Apollo Client) - GraphQL development with Apollo Client integration.
• Snowflake Cortex AI - AI_COMPLETE, AI_CLASSIFY, AI_EXTRACT, Cortex Search, and RAG applications.
• Snowflake Data Engineering - Snowflake SQL, data pipelines (Dynamic Tables, Streams, Tasks, Snowpipe), semi-structured data, Snowflake PostgreSQL, and cost optimization.
• Snowflake Snowpark Python & dbt - Snowpark Python (DataFrames, UDFs, stored procedures) and dbt with the Snowflake adapter.
• TypeScript (Axios) - TypeScript development with Axios integration.

Testing

• Cypress API Testing - Cypress development with API testing.
• Cypress Accessibility Testing - Cypress development with accessibility testing.
• Cypress Defect Tracking - Cypress development with defect tracking.
• Cypress E2E Testing - Cypress development with E2E testing.
• Cypress Integration Testing - Cypress development with integration testing.
• Jest Unit Testing - Jest development with unit testing.
• Playwright API Testing - Playwright development with API testing.
• Playwright Accessibility Testing - Playwright development with accessibility testing.
• Playwright Defect Tracking - Playwright development with defect tracking.
• Playwright E2E Testing - Playwright development with E2E testing.
• Playwright Integration Testing - Playwright development with integration testing.
• PR Review (security / performance / tests / architecture) - Focused PR reviews with severity ranking, file and line citations, and separate review angles for security, performance, tests, and architecture.
• PR Template - PR development with template integration.
• QA Bug Report - QA development with bug report integration.
• TestRail Test Case - TestRail development with test case integration.
• Vitest Unit Testing - Vitest development with unit testing.
• Xray Test Case - Xray development with test case integration.

Hosting and Deployments

• Cloudflare Email to Telegram - Setting up email-to-Telegram forwarding via Cloudflare Email Routing and Workers using the mail2tg CLI.
• Netlify - Official deployment platform integration.
• Vercel - Deployment with serverless functions, Edge Runtime, middleware, caching, CI/CD, and production-ready configuration.

Build Tools and Development

• AI Agent Specialist - TypeScript, React, Node.js, clean architecture, testing, and WHY-oriented engineering guidance.
• Alpha Skills - Quantitative factor research skills for Cursor. Evaluate factors, run backtests, mine new alpha through natural language.
• Anti-Over-Engineering - Keeping changes scoped, simple, and directly tied to the user's request.
• Anti-Sycophancy Code Discipline - 17 directives blocking the most common LLM coding honesty failures: hallucinated APIs, invented signatures, false-confidence validation, manufactured-urgency capitulation, authority-driven softening, and self-referential comments. Drop the .mdc in .cursor/rules/.
• Chrome Extension (JavaScript/TypeScript) - Chrome extension development with JavaScript and TypeScript integration.
• Code Guidelines - Code development with guidelines integration.
• Code Pair Interviews - Interview practice and collaborative coding sessions.
• Code Style Consistency - Code development with style consistency integration.
• Embedded MCU / STM32 / HAL - Embedded C/C++ development with STM32 HAL, interrupts, DMA, memory constraints, and hardware-focused testing.
• Engineering Ticket Template - Engineering development with ticket template integration.
• GitHub Code Quality - GitHub development with code quality integration.
• GitHub Instructions - GitHub development with instructions integration.
• Git Commit Messages - Git development with conventional commit messages integration.
• Kubernetes (MkDocs Documentation) - Kubernetes development with MkDocs documentation integration.
• Linux (NVIDIA CUDA, Python) - Linux development with NVIDIA CUDA and Python integration.
• Optimize (DRY, SOLID Principles) - Optimization development with DRY and SOLID principles integration.
• Project Epic Template - Project development with epic template integration.
• Python Containerization - Python development with containerization integration.
• Python (GitHub Setup) - Python development with GitHub setup integration.
• ROS / ROS2 - ROS and ROS2 packages, nodes, launch files, messages, services, actions, simulation, and testing.
• Tauri (Svelte, TypeScript Guide) - Tauri development with Svelte and TypeScript guide integration.
• TypeScript Code Convention - TypeScript development with code convention integration.
• VSCode Extension (Electron/TypeScript) - VSCode extension development with Electron and TypeScript integration.
• Web App Optimization - Web app development with optimization integration.
• Ankra CLI (Kubernetes Cluster Management) - Ankra CLI development with Kubernetes cluster management integration.

Language-Specific

• AutoML and Hyperparameter Optimization - Python ML model search, validation design, search spaces, experiment tracking, and time-series AutoML.
• Fortran - Modern Fortran scientific computing, modules, explicit interfaces, kind parameters, memory safety, and testing.
• JavaScript/TypeScript Code Quality - JavaScript and TypeScript development with code quality integration.
• JavaScript (Chrome APIs) - JavaScript development with Chrome APIs integration.
• Optimize (Rell Blockchain Code) - Optimization development with Rell Blockchain code integration.
• Pandas (scikit-learn Guide) - Pandas development with scikit-learn guide integration.
• Plasticode (Telegram API) - Plasticode development with Telegram API integration.
• PyQt6 (EEG Processing) - PyQt6 development with EEG processing integration.
• Python/TypeScript Guide - Python development with TypeScript guide integration.
• Python Best Practices - Python development with best practices integration.
• Python Developer - Python development with developer integration.
• Python Projects Guide - Python development with projects guide integration.
• PySpark ETL Best Practices - PySpark ETL development with code style, joins, window functions, map operations, and Iceberg patterns.
• PyTorch (scikit-learn) - PyTorch development with scikit-learn integration.
• R Best Practices - R development with best practices integration.
• Rust - Safe, idiomatic Rust application and library development.
• Solidity (Foundry) - Solidity development with Foundry integration.
• Solidity (Hardhat) - Solidity development with Hardhat integration.
• Solidity (React Blockchain Apps) - Solidity development with React Blockchain apps integration.
• Solana Wallet-Aware Coding - Solana wallet safety, isolated signers, program allowlists, MEV-aware transaction handling, and operational guardrails.
• TypeScript (LLM Tech Stack) - TypeScript development with LLM tech stack integration.
• TypeScript (Node.js, Next.js, AI) - TypeScript development with Node.js, Next.js, and AI integration.
• TypeScript (Node.js, Next.js, React, UI, CSS) - TypeScript development with Node.js, Next.js, React, UI, and CSS integration.
• TypeScript (Node.js, React, Vite) - TypeScript development with Node.js, React, and Vite integration.
• TypeScript (React, Next.js, Cloudflare) - TypeScript development with React, Next.js, and Cloudflare integration.
• TypeScript (React, NextUI, Supabase) - TypeScript development with React, NextUI, and Supabase integration.
• TypeScript (shadcn/ui, Next.js) - TypeScript development with shadcn/ui and Next.js integration.
• TypeScript (Vite, Tailwind) - TypeScript development with Vite and Tailwind integration.
• TypeScript (Vue.js) - TypeScript development with Vue.js integration.
• TypeScript (Zod, Tailwind, Next.js) - TypeScript development with Zod, Tailwind, and Next.js integration.
• WebAssembly (Z80 Cellular Automata) - WebAssembly development with Z80 Cellular Automata integration.
• TypeScript (Next.js) - TypeScript development with Next.js integration.
• TypeScript (Next.js, React) - TypeScript development with Next.js and React integration.
• TypeScript (Next.js, React, Tailwind, Supabase) - TypeScript development with Next.js, React, Tailwind, and Supabase integration.
• TypeScript (Next.js, Supabase) - TypeScript development with Next.js and Supabase integration.
• TypeScript (Node.js, Next.js App) - TypeScript development with Node.js and Next.js app integration.
• TypeScript (React) - TypeScript development with React integration.
• TypeScript (Clasp App Script) - TypeScript development with Clasp app script integration.
• C++ Programming Guidelines - C++ development with programming guidelines integration.
• TensorFlow and Deep Learning - TensorFlow model development, training, evaluation, export, and deployment.

Security

• DevSecOps, SSDLC, and AppSec - Secure coding, secret handling, dependency hygiene, authentication, authorization, security testing, and compliance documentation.

Documentation

• Gherkin Style Testing - Behavior-driven scenarios and acceptance criteria.
• How-To Documentation - Task-oriented guides and procedural documentation.
• README Best Practices - README documentation with best practices integration.

Directories

• CursorList
• CursorDirectory

How to Use

Project Rules

1. Install Cursor AI if you haven't already.
2. Browse the rules above to find an .mdc rule that suits your needs.
3. Create a .cursor/rules/ directory in your project if it does not already exist.
4. Copy the chosen .mdc file into .cursor/rules/.
5. Customize the rule as needed for your specific project requirements.

Contributing

Contributions are welcome! If you have a great Cursor rule to share:

1. Fork this repository.

2. Choose a descriptive slug for the rule, such as react-typescript or python-fastapi.

3. Add the canonical .mdc rule under rules/.

4. New rules/*.mdc files must start with frontmatter like this:

   ---
   description: One-line summary of what this rule helps Cursor do
   globs: **/*.ts, **/*.tsx
   alwaysApply: false
   ---

   The description field explains the rule's purpose to Cursor and contributors. The globs field lists the file patterns where the rule should auto-attach. Use alwaysApply: false to keep the rule scoped to matching or requested context, and use alwaysApply: true only for universal guidance that should apply to every request.

5. Update the main README.md file, adding your contribution to the appropriate category.

6. Ensure your contribution follows the repository formatting and naming guidelines.

7. Submit a pull request.

Please ensure your contribution is original or properly credited if based on existing work. Keep descriptions neutral, practical, and focused on reusable Cursor rule value.

Footnotes

Sponsorships

• coderabbit.ai - Cut code review time and bugs in half.
• Unblocked MCP - Team knowledge for Cursor workflows.
• Warp - Terminal workflows for coding with multiple AI agents.