Cursor Next.js 编码规范：来自 PatrickJS/awesome-cursorrules (40k stars) 的 nex，适用于各类文档与内容的智能化处理。
Cursor Next.js 编码规范：来自 PatrickJS/awesome-cursorrules (40k stars) 的 nex，适用于各类文档与内容的智能化处理。
**文件来源:** PatrickJS/awesome-cursorrules → `rules/nextjs-react-tailwind-cursorrules-prompt-file.mdc`
**原仓库:** https://github.com/PatrickJS/awesome-cursorrules
**评分:** ⭐ 仓库 40k stars (社区最权威 Cursor rules 合集)
把 `nextjs-react-tailwind-cursorrules-prompt-file.mdc` 这条 Cursor 编码规则打包成可调用的 AI skill,帮你把代码生成统一到一致的标准上。
> Cursor rules for Next.js development with React and Tailwind CSS integration.
globs: **/*
alwaysApply: false
---
- You are an expert in TypeScript, Node.js, Next.js App Router, React, Shadcn UI, and Tailwind and Framer Motion.
- Code Style and Structure
- Write concise, technical TypeScript code with accurate examples.
- Use functional and declarative programming patterns; avoid classes.
- Prefer iteration and modularization over code duplication.
- Use descriptive variable names with auxiliary verbs (e.g., isLoading, hasError).
- Structure files: exported component, subcomponents, helpers, static content, types.
- Naming Conventions
- All components should go in src/components and be named like new-component.tsx
- Use lowercase with dashes for directories (e.g., components/auth-wizard).
- Favor named exports for components.
- TypeScript Usage
- Use TypeScript for all code; prefer interfaces over types.
- Avoid enums; use maps instead.
- Use functional components with TypeScript interfaces.
- Syntax and Formatting
- Use the "function" keyword for pure functions.
- Avoid unnecessary curly braces in conditionals; use concise syntax for simple statements.
- Use declarative JSX.
- UI and Styling
- Use Shadcn UI, and Tailwind for components and styling.
- Implement responsive design with Tailwind CSS; use a mobile-first approach.
- Performance Optimization
- Minimize 'use client', 'useEffect', and 'setState'; favor React Server Components (RSC).
- Wrap client components in Suspense with fallback.
- Use dynamic loading for non-critical components.
- Optimize images: use WebP format, include size data, implement lazy loading.
- Key Conventions
- Use 'nuqs' for URL search parameter state management.
- Optimize Web Vitals (LCP, CLS, FID).
- Limit 'use client':
- Favor server components and Next.js SSR.
- Use only for Web API access in small components.
- Avoid for data fetching or state management.
- Follow Next.js docs for Data Fetching, Rendering, and Routing.
- While creating placeholder images as a part of your seed data, use local fixtures or a stable project-approved image source instead of deprecated placeholder services.
- Place both the /app and /components folders under a /src directory. This organization offers several benefits:
- It helps maintain a clean and organized project structure.
- It allows for easier navigation and management of components and pages.
- It adheres to common industry standards, making it easier for other developers to understand and contribute to the project.
- It provides a clear separation between application logic (in /src/app) and UI components (in /src/components), improving code readability and reusability.
- It simplifies the process of creating new pages and components, as you can easily find the corresponding files in the /src directory.
- It makes the project more modular and easier to scale as the application grows.
- It adheres to the principle of separation of concerns, where di
...(完整内容在原仓库)...有问题或建议,在本 skill 下留言。
把 `nextjs-react-tailwind-cursorrules-prompt-file.mdc` 这条 Cursor 编码规则打包成可调用的 AI skill,帮你把代码生成统一到一致的标准上。
> Cursor rules for Next.js development with React and Tailwind CSS integration.