Skip to content

Latest commit

Β 

History

History
324 lines (232 loc) Β· 12.2 KB

File metadata and controls

324 lines (232 loc) Β· 12.2 KB

Awesome Cursor Rules

Project Status Website GitHub Pages Translation Progress GitHub Stars GitHub Forks License

πŸ‡¨πŸ‡³ δΈ­ζ–‡ | πŸ‡ΊπŸ‡Έ English

A curated collection of Cursor AI coding rules for modern development stacks δΈΊδΈ­ζ–‡εΌ€ε‘θ€…ζ‰“ι€ ηš„ Cursor AI ηΌ–η¨‹θ§„εˆ™ι›†εˆ - ζŸ₯ηœ‹δΈ­ζ–‡η‰ˆ

132 rule files Β· 32 tech domains Β· 190 technical docs Β· 6,500+ lines

πŸš€ Quick Start Β· πŸ“‚ Browse Rules Β· πŸ’‘ Usage Guide Β· πŸ“š Docs Β· 🀝 Contributing


πŸ“‹ Table of Contents


What is this?

Awesome Cursor Rules is a curated collection of Cursor AI coding assistant rules. This project provides comprehensive translations and localized content for global developers:

  • 🎯 Accurate Translation β€” High-quality translations with precise technical terminology
  • πŸ“‚ Clear Structure β€” Organized by technology domain for easy discovery
  • πŸš€ Ready to Use β€” Copy .cursorrules file and start coding immediately
  • 🌍 Bilingual Support β€” Complete English and Chinese documentation
  • ⚑ 132 Rules β€” Covering frontend, backend, mobile, AI, DevOps, and more

🌐 Online Documentation: awesome-cursorrules-zh.js.org


What is .cursorrules?

.cursorrules is a project-level configuration file for the Cursor AI editor that defines how AI should assist your coding:

Feature Description Example
Coding Standards Define code style and naming conventions PascalCase components, camelCase functions
Tech Stack Specify frameworks, libraries, toolchains React + TypeScript + Tailwind CSS
Best Practices Automatically apply industry standards Error handling, performance optimization
AI Behavior Customize AI response style Detailed comments, functional programming

πŸ’‘ Essence: A "project handbook" for AI assistants that ensures consistent, high-quality code generation


✨ Features

πŸ† Popular Tech Stacks

TypeScript
Most covered
React
Frontend leader
Python
Backend & AI
Next.js
Full-stack
Docker
DevOps

πŸ“Š Coverage Areas

  • 🌐 App Development: Frontend, Backend, Mobile, Database, Systems
  • πŸ€– AI & Data: Machine Learning, Data Science, Data Engineering
  • ☁️ Infrastructure: DevOps, Cloud, Edge Computing, Security
  • πŸ”¬ Specialized: Blockchain, IoT, Quantum Computing, Bio Tech

πŸš€ Quick Start

Installation

# Clone the repository
git clone https://github.com/LessUp/awesome-cursorrules-zh.git

# Browse available rules
cd awesome-cursorrules-zh
ls rules/frontend/react/

Usage

# Copy rule to your project
cp rules/frontend/react/nextjs-typescript/.cursorrules /path/to/your/project/

That's it! Open your project in Cursor and the AI will follow the rules automatically.

Quick Examples

Tech Stack Rule Command
Next.js + TypeScript nextjs-typescript cp rules/frontend/react/nextjs-typescript/.cursorrules ./
Vue 3 composition-api cp rules/frontend/vue/composition-api/.cursorrules ./
FastAPI fastapi-api-example cp rules/backend/python/fastapi-api-example/.cursorrules ./
Flutter flutter-app-expert cp rules/mobile/flutter/flutter-app-expert/.cursorrules ./

πŸ“– Complete Quick Start Guide


πŸ“‚ Rule Categories

🌐 App Development
Domain Directory Technologies
Frontend rules/frontend/ React, Vue, Angular, Svelte, SolidJS, TypeScript
Backend rules/backend/ Node.js, Python, Go, Java, PHP, .NET, Elixir
Mobile rules/mobile/ Flutter, React Native, SwiftUI, Jetpack Compose
Database rules/database/ Cloud-native, Spatiotemporal
Systems rules/systems/ Modern C++, Rust
πŸ€– AI & Data
Domain Directory Technologies
AI/ML rules/ai/ Computer Vision, MLOps, Knowledge Graphs, Edge AI
Data Science rules/data-science/ Pandas, PyTorch, TensorFlow, Scikit-learn
Data Engineering rules/data/ Kafka, Spark, Flink, Data Warehouses
☁️ Infrastructure & DevOps
Domain Directory Technologies
DevOps rules/devops/ Docker, Kubernetes, Terraform, CI/CD
Cloud rules/cloud/ Middleware, Serverless
Edge Computing rules/edge/ AI Inference, Model Compression
Security rules/security/ Zero Trust, Privacy Computing, Homomorphic Encryption
πŸ”¬ Specialized Domains
Domain Directory Technologies
Blockchain rules/blockchain/ Solidity, Web3, Smart Contracts, Foundry
IoT rules/iot/ Embedded, Digital Twins
Quantum Computing rules/quantum/ Quantum Error Correction, Superconducting
Bio Tech rules/bio/ Bioelectronics, Biosensors
Hardware rules/hardware/ Neuromorphic Chips, Photon Computing
Gaming rules/gaming/ DragonRuby, Cloud Gaming
πŸ› οΈ Tools & General
Domain Directory Technologies
Tools rules/tools/ Convex, GitHub Quality
General rules/general/ Code Guidelines, Style Consistency, Testing

See full directory structure in rules/


πŸ’‘ Usage

Single Tech Stack

cp rules/frontend/react/nextjs-typescript/.cursorrules ./

Multiple Tech Stacks

Option 1: Merge Rules

cat rules/frontend/react/nextjs-typescript/.cursorrules > .cursorrules
echo "" >> .cursorrules
cat rules/backend/python/fastapi-api-example/.cursorrules >> .cursorrules

Option 2: Directory-Level Rules (Recommended for monorepos)

project/
β”œβ”€β”€ .cursorrules           # Global rules
β”œβ”€β”€ frontend/
β”‚   └── .cursorrules       # Frontend-specific rules
└── backend/
    └── .cursorrules       # Backend-specific rules

Customize Rules

# Append project-specific rules
cat >> .cursorrules << 'EOF'

## Project Custom Rules
- API routes use /api/v1 prefix
- All models must include created_at and updated_at fields
- Prefer functional components over class components
EOF

πŸ“– Complete Best Practices Guide


πŸ“Š Statistics

Metric Value
Rule Files 132 .cursorrules
Tech Domains 32 categories
Tech Documents 190 Markdown files
Total Lines 6,500+ lines
Translation 100% Chinese + English
Coverage Frontend, Backend, Mobile, AI, DevOps, Blockchain, IoT, etc.

Top Technologies

TypeScript  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ  29 rules
React       β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ            19 rules
Tailwind    β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ                   13 rules
Python      β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ                     11 rules
Next.js     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ                         8 rules
Node.js     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ                          7 rules
Docker      β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ                          7 rules

πŸ“š Documentation

Document Description Link
πŸš€ Quick Start 5-minute getting started guide Online Β· GitHub
πŸ“– Installation Detailed setup instructions Online Β· GitHub
πŸ’‘ Best Practices Configuration & usage tips Online Β· GitHub
πŸ”§ Troubleshooting Common issues & solutions Online Β· GitHub
πŸ“‹ API Reference Rule format reference Online Β· GitHub
πŸ“ Changelog Version history English Β· δΈ­ζ–‡

🀝 Contributing

Contributions are welcome in all forms:

  • πŸ› Report Issues β€” Submit an Issue
  • πŸ”§ Improve Content β€” Submit a Pull Request
  • πŸ”„ Sync Upstream β€” Help keep this project in sync with the original
  • πŸ“ Enhance Documentation β€” Improve guides and documentation

See Contributing Guide for details.


πŸ™ Acknowledgments

This project is a Chinese localization of PatrickJS/awesome-cursorrules. Special thanks to the original author and all contributors.


πŸ“„ License

MIT License


If this project helps you, please give it a ⭐ Star!

🌐 Visit Official Website Β· ⬆ Back to Top