GStars
    PatrickJS

    PatrickJS/awesome-cursorrules

    #341 this week

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

    education
    awesome
    awesome-list
    cursor
    cursor-ai-editor
    cursorrules
    JavaScript
    CC0-1.0
    40.6K stars
    3.5K forks
    40.6K GitHub watchers
    Updated 8/14/2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Use Cases & Benefits

    • Enhances Cursor AI editor with project-specific rules and behaviors using Markdown-based .mdc configuration files.
    • Enables consistent, reusable coding standards and tailored AI code suggestions aligned with project architecture and team conventions.
    • Use for customizing AI-assisted coding workflows in frontend frameworks like Next.js, React, Angular, and Vue.
    • Use for enforcing backend and full-stack best practices in environments such as Python FastAPI, Node.js, Go, and Laravel.
    • Use for improving mobile app development with tailored rules for platforms like Android Jetpack Compose, Flutter, and React Native Expo.

    About awesome-cursorrules

    Awesome Cursor Rules Awesome

    Awesome Cursor Logo

    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.

    CodeRabbit.ai Sponsorship Logo

    Unblocked MCP- Supercharge Cursor with your team’s knowledge

    Unblocked Sponsorship Logo

    Warp - Built for coding with multiple AI agents

    Warp Sponsorship Logo

    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:

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

    Discover Repositories

    Search across tracked repositories by name or description