awesome-cursorrules Documentation

Configuration files that enhance Cursor AI editor experience with custom rules and behaviors

39,440 stars MDX 1 file · ~12,865 tokens #awesome#awesome-list#cursor#cursor-ai-editor#cursorrules
RAW Doc

1. Project Overview & Quickstart (PatrickJS/awesome-cursorrules)

Awesome Cursor Rules [](https://awesome.re)

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

Contents

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

Backend and Full-Stack

Mobile Development

Games and Graphics

CSS and Styling

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.
  • React (Zustand) - React state management with Zustand stores, selectors, middleware, persistence, and testing.
  • TanStack Query v5 - Query options, query key factories, mutations, optimistic updates, infinite queries, Suspense, and prefetching.
  • Vue (Pinia) - Vue 3 state management with Pinia stores, Composition API usage, SSR, persistence, and testing.

Database and API

Testing

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

Language-Specific

Security

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

Documentation

Directories

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:

    yaml
    ---
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.

2. Official Technical Reference & Guides (PatrickJS/docs)

docs

The docs that Cursor can see out-of-the-box.

Contributing

Simply add a row to docs.jsonl and submit a PR. Please include the project's name, a url for our crawler to start at, and a prefix url that all crawleded urls should be children of.

Once accepted, we'll crawl your documentation and make it available to all users of Cursor. Anyone will be able to reference the project with a simple '@ProjectName' command.

What is Cursor?

Cursor is a code editor designed for pair-programming with AI. In Cursor, you can chat with an AI that sees your entire codebase, edit code using GPT-4, and easily invoke an AI to fix your linter errors or stack-traces. Using Cursor is easy, it's a fork of VSCode, and you can import your extensions in one-click.

What is this repo?

In Cursor, you can show GPT-4 project documentation to improve it's answers with @ commands like @Langchain and @Tokio. You can also spawn our crawler to add your own documention by typing "@Add" in chat.

This repo is the list of documentation that's available for all users of Cursor with no "@Add" command required.

Explore Related Technologies & Topics

View All 9,111+ Repositories →

Discover similar high-velocity repositories, agent skills, and OpenAPI specifications across the ecosystem.

#awesome Browse awesome catalog → #awesome-list Browse awesome-list catalog → #cursor Browse cursor catalog → #cursor-ai-editor Browse cursor-ai-editor catalog → #cursorrules Browse cursorrules catalog → ⚡ MCP Servers Model Context Protocol → 🧠 Agent Skills Prompt & rule files → 🔌 OpenAPI Specs REST & Swagger schemas →