GitPedia

Awesome cursorrules

๐Ÿ“„ Configuration files that enhance Cursor AI editor experience with custom rules and behaviors

From PatrickJSยทUpdated June 17, 2026ยทView on GitHubยท

Cursor Project Rules enhance Cursor AI editor behavior with project-specific guidance and reusable coding standards. The project is written primarily in JavaScript, distributed under the Creative Commons Zero v1.0 Universal license, first published in 2024. It has gained significant community traction with 40,019 stars and 3,418 forks on GitHub. Key topics include: awesome, awesome-list, cursor, cursor-ai-editor, cursorrules.

Awesome Cursor Rules Awesome

<p align="center"> <a href="https://coderabbit.ai/?utm_source=oss&utm_medium=sponsorship&utm_campaign=awesome-cursorrules" target="_blank"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./LOCKUP_VERTICAL_25D_DARK.png"> <img alt="Awesome Cursor Logo" src="./LOCKUP_VERTICAL_25D_LIGHT.png" width="500"> </picture> </a> </p>

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.

<h2>Sponsorships</h2> <p align="center"> <h3><a href="https://coderabbit.ai/?utm_source=oss&utm_medium=sponsorship&utm_campaign=awesome-cursorrules">coderabbit.ai - Cut Code Review Time & Bugs in Half. Instantly.</h3> <a href="https://coderabbit.ai/?utm_source=oss&utm_medium=sponsorship&utm_campaign=awesome-cursorrules"> <img alt="CodeRabbit.ai Sponsorship Logo" src="./cr_logo.png" width=350> </a> <h3><a href="https://getunblocked.com/unblocked-mcp/?utm_source=oss&utm_medium=sponsorship&utm_campaign=awesome-cursorrules">Unblocked MCP- Supercharge Cursor with your teamโ€™s knowledge</h3> <a href="https://getunblocked.com/unblocked-mcp/?utm_source=oss&utm_medium=sponsorship&utm_campaign=awesome-cursorrules"> <img alt="Unblocked Sponsorship Logo" src="https://github.com/claire-gong-18/awesome-cursorrules/blob/main/Unblocked-logo-sq-words-over-gradient-1024w.png?raw=true" width=250> </a> <h3><a href="https://go.warp.dev/awesome-cursorrules">Warp - Built for coding with multiple AI agents</h3> <a href="https://go.warp.dev/awesome-cursorrules"> <img alt="Warp Sponsorship Logo" src="https://github.com/user-attachments/assets/8d50d811-fabe-4610-a537-c5a5a9224864" width=350> </a> </p>

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

Contributors

Showing top 12 contributors by commit count.

PatrickJS

PatrickJS

61 commits

oliviacraft

oliviacraft

4 commits

usm4nhafeez

usm4nhafeez

4 commits

feddelegrand7

feddelegrand7

3 commits

clubanderson

clubanderson

3 commits

ikhare

ikhare

2 commits

tks-00

tks-00

2 commits

connerlambden

connerlambden

2 commits

VernonOY

VernonOY

2 commits

santoshyadavdev

santoshyadavdev

2 commits

SH20RAJ

SH20RAJ

2 commits

pgnjidic

pgnjidic

2 commits

View all contributors on GitHub โ†’

This article is auto-generated from PatrickJS/awesome-cursorrules via the GitHub API.Last fetched: 6/17/2026