cursor.link

Share and discover Cursor rules – like Gist, but for Cursor IDE rules

cursor.link is a platform for creating, sharing, and discovering Cursor IDE rules. Create custom rules with different application types, share them with the community, and install them directly via CLI using a shadcn-style registry system.

✨ Features

🖋️ Rich Rule Editor - Create cursor rules with live preview and token counting
🔄 Rule Types - Support for Always Apply, Intelligent, File-specific, and Manual rules
🔗 Easy Sharing - Share rules with unique URLs and public/private visibility
📦 CLI Integration - Install rules directly via npx shadcn add command
👤 User Dashboard - Manage all your rules in one place
🔍 Public Discovery - Browse and discover community-shared rules
🎨 Modern UI - Beautiful dark theme with Tailwind CSS and Radix components

🛠️ Tech Stack

Frontend

Next.js 15 - App Router with React 19
TypeScript - Full type safety
Tailwind CSS v4 - Modern styling system
Radix UI - Accessible component primitives
React Hook Form + Zod - Form handling and validation

Backend

PostgreSQL - Primary database (via Neon.tech)
Drizzle ORM - Type-safe database queries
Better Auth - Modern authentication with magic links
Inbound Email - Transactional email service

Tools & Services

Vercel - Deployment and hosting
React Scan - Performance monitoring
Sonner - Toast notifications

🚀 Getting Started

Prerequisites

Node.js 18+
PostgreSQL database (we recommend Neon)
Inbound Email account (get your API key from inbound.new)

Environment Setup

Create a .env.local file in the root directory:

# Database
DATABASE_URL="postgresql://username:password@host/database"

# Email Service (get from inbound.new)
INBOUND_API_KEY="your_inbound_api_key"

# Auth (automatically generated)
BETTER_AUTH_SECRET="your_auth_secret"
BETTER_AUTH_URL="http://localhost:3000"

Installation

Clone the repository

git clone https://github.com/your-username/cursor.link.git
cd cursor.link

Install dependencies
```
npm install
```

Set up the database

# Generate migrations
npm run db:generate

# Apply migrations
npm run db:migrate

Start the development server
```
npm run dev
```
Open your browser Navigate to http://localhost:3000

📁 Project Structure

cursor.link/
├── app/                          # Next.js app directory
│   ├── [userId]/[ruleId]/       # Public rule viewer pages
│   ├── api/                     # API routes
│   │   ├── auth/               # Authentication endpoints
│   │   ├── cursor-rules/       # CRUD operations for rules
│   │   ├── my-rules/           # User's personal rules
│   │   ├── public-rule/        # Public rule access
│   │   └── registry/           # shadcn-style CLI registry
│   ├── dashboard/              # User dashboard
│   ├── login/                  # Authentication pages
│   └── page.tsx               # Homepage/editor
├── components/                  # Reusable UI components
│   ├── auth/                   # Authentication components
│   ├── ui/                     # Base UI components
│   └── header.tsx             # Site header
├── lib/                        # Shared utilities
│   ├── auth.ts               # Authentication configuration
│   ├── db.ts                 # Database connection
│   ├── schema.ts             # Database schema
│   └── utils.ts              # Helper utilities
└── drizzle/                    # Database migrations

🔌 API Reference

Rules Management

Get Rules

GET /api/cursor-rules
GET /api/cursor-rules?ruleId=<id>

Fetch all accessible rules or a specific rule by ID.

Create Rule

POST /api/cursor-rules
Content-Type: application/json

{
  "title": "my-rule",
  "content": "Rule content...",
  "ruleType": "always|intelligent|specific|manual",
  "isPublic": false
}

Update Rule

PUT /api/cursor-rules
Content-Type: application/json

{
  "id": "rule-id",
  "title": "updated-title",
  "content": "Updated content...",
  "ruleType": "always",
  "isPublic": true
}

Registry (CLI Integration)

Install via CLI

npx shadcn add https://cursor.link/api/registry/[ruleId]

Registry Item

GET /api/registry/[ruleId]

Returns a shadcn-compatible registry item for CLI installation.

Public Access

View Public Rule

GET /api/public-rule/[userId]/[ruleId]

Access a public rule and increment view count.

My Rules

GET /api/my-rules

Get all rules belonging to the authenticated user.

🎯 Usage

Creating Rules

Visit the homepage - Start creating immediately without login
Choose rule type - Select from Always Apply, Intelligent, File-specific, or Manual
Write your rule - Use the built-in editor with syntax highlighting
Save and share - Login to save privately or share publicly

Rule Types

Always Apply - Applied to every chat and cmd-k session
Apply Intelligently - Applied when AI determines relevance
Apply to Specific Files - Applied when file matches specified patterns
Apply Manually - Applied only when @-mentioned

CLI Installation

Share your rules with the community by making them public, then others can install them directly:

npx shadcn add https://cursor.link/api/registry/your-rule-id

This installs the rule to ~/.cursor/rules/ automatically.

🤝 Contributing

We welcome contributions! Here's how to get started:

Development Setup

Fork the repository on GitHub

Clone your fork

git clone https://github.com/your-username/cursor.link.git

Create a feature branch
```
git checkout -b feature/amazing-feature
```
Follow the setup instructions above to get the project running locally

Code Style

TypeScript - All new code should be typed
ESLint - Run npm run lint before committing
Prettier - Code formatting is enforced
Conventional Commits - Use conventional commit messages

Contribution Areas

🐛 Bug fixes - Help improve stability
✨ New features - Add functionality users want
📚 Documentation - Improve guides and API docs
🎨 UI/UX - Enhance the user experience
⚡ Performance - Optimize loading and responsiveness
🔧 Tooling - Improve developer experience

Pull Request Process

Update documentation for any new features
Add tests for new functionality
Ensure CI passes - All checks must be green
Request review from maintainers
Address feedback and iterate

Local Development Tips

Hot reload - Changes reflect immediately in development
Database changes - Run migrations after schema updates
Email testing - Set up Inbound for magic link testing
API testing - Use the built-in API routes for testing

🚀 Deployment

Vercel (Recommended)

Fork the repository
Import to Vercel from your GitHub account
Add environment variables in Vercel dashboard
Deploy - Automatic deployments on every push

Environment Variables for Production

# Database (production)
DATABASE_URL="postgresql://prod_user:password@host/database"

# Email Service
INBOUND_API_KEY="your_production_api_key"

# Auth
BETTER_AUTH_SECRET="your_secure_random_string"
BETTER_AUTH_URL="https://your-domain.com"

Custom Deployment

The app is a standard Next.js application and can be deployed to any platform that supports Node.js:

Vercel (recommended)
Netlify
Railway
Digital Ocean App Platform
AWS Amplify

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

Cursor - For creating an amazing AI-powered IDE
shadcn/ui - For the incredible component library
v0.dev - For rapid prototyping assistance
Vercel - For seamless deployment
Neon - For serverless PostgreSQL

Built with ❤️ for the Cursor community. Share your rules today!

R44VC0RP/cursor.link