Cursor IDE, the AI-first code editor.
Build software faster with an editor designed for AI pair programming. Get smart completions, built-in chat, and edits across your whole codebase.
add input validation with zod
@codebase where do we handle auth?
What is Cursor IDE?
Cursor is an AI-first code editor. Built on VS Code, it adds AI features to tools you already know.
Core features
Twelve capabilities in three groups. Pick a group to see what it covers.
Shortcuts and context
The keys you will use every day, and the @ mentions that give AI the right context. Ctrl on Windows and Linux.
Prompts and pro tips
Thirty-five tips and prompt templates. Search, filter, and copy the example.
Project rules
Rules tell Cursor how your project works. Start from a template, then make it yours.
Next.js + TypeScript + Tailwind
PopularModern Next.js app with TypeScript and Tailwind CSS
# Project Context You are working on a Next.js 15 application with TypeScript and Tailwind CSS. ## Tech Stack - Next.js 15 with App Router - TypeScript with strict mode - Tailwind CSS for styling - React 19 - ESLint + Prettier configured ## Code Style - Use functional components with TypeScript interfaces - Implement proper error boundaries - Use server components by default, client components only when needed - Follow REST API conventions for route handlers - Implement proper loading and error states ## File Structure - Components in /app/components - API routes in /app/api - Utilities in /lib - Types in /types ## Best Practices - Always use semantic HTML - Implement proper SEO with metadata - Ensure accessibility (ARIA labels, keyboard navigation) - Optimize images with next/image - Use dynamic imports for code splitting - Implement proper error handling - Write clean, self-documenting code ## Testing - Write unit tests for utilities - Integration tests for API routes - Component tests with React Testing Library ## Do NOT - Use 'any' type - always define proper types - Ignore error handling - Use inline styles when Tailwind classes exist - Create unnecessary client components - Forget to validate and sanitize user input
Keep rules concise
Limit to 50-100 lines. Focus on your project's conventions, not general advice
Be specific
Include exact package versions, file paths, and naming conventions
Include examples
Show code snippets of preferred patterns
Define boundaries
Clearly state what not to do
Update regularly
Rules should evolve with your project
Scope appropriately
Use folder-specific rules for different parts of your app
Workflows and use cases
Step-by-step prompts for six real projects, and four everyday workflows.
Building a full-stack SaaS app
Advanced · 2-4 weeksBuild a full SaaS app from scratch with Cursor
- SetupCreate a Next.js 14 app with TypeScript, Tailwind, Prisma, and NextAuthUse Agent for the initial scaffolding
- Schema@schema.prisma - Design a multi-tenant database schema for [your app]Let AI suggest relations and indexes
- AuthImplement NextAuth with Google and GitHub providers, add role-based accessReference NextAuth docs with @docs
- APICreate CRUD API routes with proper validation using ZodGenerate tests alongside APIs
- UIBuild responsive dashboard with charts, tables, and formsPaste a screenshot into chat for UI inspiration
- DeploySet up CI/CD with GitHub Actions and deploy to VercelLet Cursor write the workflow files
Refactoring a legacy codebase
Intermediate · 1-2 weeksModernize an old JavaScript codebase to TypeScript
- Analysis@codebase - Analyze code quality and identify refactoring opportunitiesStart with a high-level assessment
- TypesConvert this file to TypeScript with proper types and interfacesDo one module at a time
- PatternsRefactor class components to functional components with hooksUse Agent (Cmd+I) for multi-file changes
- SpeedFind and fix performance bottlenecks, add memoizationAsk for before/after metrics
- TestsAdd full tests for refactored codeAim for 80% coverage
Building a Chrome extension
Intermediate · 3-5 daysCreate a Chrome extension with AI-powered features
- ManifestCreate Chrome extension manifest v3 with content scripts and popupSpecify permissions needed
- ContentBuild content script to extract and analyze page contentHandle different website structures
- PopupCreate React popup with Tailwind stylingKeep it lightweight
- WorkerSet up service worker for API calls and storageUse Chrome storage API
- AIAdd AI summarization and translation featuresHandle API keys securely
API to API migration
Advanced · 1-2 weeksMove from REST to GraphQL or switch between API services
- AnalysisCompare REST endpoints with GraphQL schema designMap all endpoints first
- SchemaDesign GraphQL schema with types, queries, and mutationsConsider future needs
- ResolversCreate resolvers with data loaders for better performanceBatch database queries
- ClientUpdate frontend to use GraphQL with Apollo ClientAdd proper caching
- RolloutCreate migration plan with feature flags and rollbackTest thoroughly
Mobile app with React Native
Intermediate · 2-3 weeksBuild a cross-platform mobile app using React Native and Expo
- SetupInitialize Expo app with TypeScript, navigation, and common librariesUse Expo managed workflow
- UICreate reusable components with platform-specific stylingTest on both iOS and Android
- StateImplement Redux Toolkit with persist and async storageKeep state minimal
- APIConnect to backend API with proper error handlingHandle offline scenarios
- NativeAdd camera, location, and push notificationsRequest permissions properly
Data pipeline automation
Advanced · 1 weekBuild an automated data processing pipeline with Python
- IngestCreate ETL pipeline to ingest data from multiple sourcesHandle different formats
- ProcessBuild data cleaning and transformation logic with PandasOptimize for large datasets
- ValidateAdd data quality checks and validation rulesLog all issues
- StoreStore processed data in PostgreSQL with proper indexingConsider partitioning
- MonitorAdd monitoring, alerting, and retry logicUse Airflow or similar
Building a new feature
- Start with a comment describing the feature
- Let Cursor generate the initial structure
- Use chat to refine specific parts
- Ask Agent to generate the tests
- Review and polish with AI suggestions
Debugging complex issues
- Paste error message in chat
- Ask Cursor to explain the issue
- Get suggested fixes with explanations
- Apply fixes with one click
- Verify with AI-generated tests
Code refactoring
- Select code to refactor
- Describe desired improvements
- Review AI suggestions
- Apply changes across files
- Ensure tests still pass
Learning new technologies
- Ask Cursor about the technology
- Get example implementations
- Understand best practices
- Generate boilerplate code
- Learn from AI explanations
Learning path
From first install to leading your team, in three stages. Tick tasks off as you go; progress saves in your browser.
- Day 1-2Installation and setupMilestone: complete your first AI-assisted edit
- Day 3-5Basic AI featuresMilestone: build a simple app with AI assistance
- Day 6-8Context and documentationMilestone: document an entire module
- Day 9-14First real projectMilestone: complete and deploy a project
- Week 1Advanced promptingMilestone: refactor a complex module
- Week 2Multi-file operationsMilestone: complete a codebase-wide refactor
- Week 3Rules and automationMilestone: a fully configured project with rules
- Month 1Architecture and designMilestone: design and build a production system
- Month 2Team workflowsMilestone: lead team adoption of Cursor
- OngoingCutting edgeMilestone: become the Cursor expert on your team
How Cursor compares
Cursor against the editors and assistants people usually weigh it against.
| Feature | Cursor | VS Code |
|---|---|---|
| AI integration | Built in | Through extensions such as GitHub Copilot |
| Code completion | Multi-line AI (Tab) | IntelliSense, AI with an extension |
| Chat and agent | Built in | With an extension |
| Codebase understanding | Indexes the whole project | Depends on the extension |
| Extension support | VS Code compatible | Full support |
Plans and features change often. Check each vendor's site before you buy.
Videos and podcasts
Tutorials worth your time, and the founders on how and why they built Cursor.
Troubleshooting
Common problems, the fixes to try in order, and how to avoid them next time.
Cursor is running slowly
- Clear chat history (archive old chats)
- Disable unused extensions
- Switch to a faster model
- Restart Cursor to clear memory
Autocomplete is laggy
- Check internet connection stability
- Disable autocomplete for very large files
- Close files you are not using
High memory usage
- Close unused tabs and editors
- Limit number of open projects
- Clear Cursor cache
- Exclude build folders from indexing (.cursorignore)
Pro costs $20/month, and there is a free Hobby plan with limited agent requests and Tab completions. Try it on your own projects first and upgrade if the time saved is worth it to you.
Yes. Cursor is built on VS Code and supports nearly all VS Code extensions. You can import your full VS Code setup with one click.
Cursor is SOC 2 Type II certified and has a Privacy Mode in which your code is not stored or used for training. AI features still send code to Cursor and its model providers to work.
Models from Anthropic (Claude), OpenAI (GPT) and Google (Gemini), plus Cursor's own models. You can switch between them per chat based on your needs.
Basic editing works offline since it's built on VS Code. AI features need an internet connection, but you can code normally without it.
Cursor imports your VS Code settings, extensions, keybindings, and themes with one click during setup.

Ready to code with AI in your editor?
Download Cursor and work through the guide. If you want AI built into your product, book a call.