Next.js Cursor Rules Starter (Free)

Three Next.js rules that fix the mistakes agents make most often, ready to drop into .cursor/rules/, plus a linter.

Next.js Cursor Rules Starter (Free) cover

What it is

3 Cursor project rules for Next.js you can drop into a repo today, plus lint_rules.py, which tells you why a Cursor rule isn't loading.

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 5 tests OK on Python 3.13 and 3.10.

Real terminal output from Next.js Cursor Rules Starter: demo and passing tests

The rules (in .cursor/rules/)

RuleLoadsFirst instruction
nextjs-overview.mdcalwaysCheck the next version in package.json before using an API
nextjs-async-request-apis.mdcby file (app//page.tsx, app//layout.tsx, app//route.ts, src/app//page.tsx, src/app//layout.tsx, src/app//route.ts)params and searchParams are Promises: const { slug } = await props.params
nextjs-server-actions.mdcAgent picks itTreat every 'use server' function as a public POST endpoint: re-check authentication and authorization inside the...

Install

Copy .cursor/rules/ into your project root (keep the .mdc extension). Then check them against your code:

python3 tools/lint_rules.py .cursor/rules --project .
./tools/demo.sh        # copies the rules into examples/sample-app and lints them
./run_tests.sh

Honest limits

  • Rules guide the model; they don't enforce anything.
  • Check version-specific advice against your installed versions.

Format and license

Zip, 12 KB, v1.0, 22 files. Free to use, modify and share for any purpose, including commercial work, as long as this notice stays in copies. Not affiliated with or endorsed by Cursor (Anysphere) or Vercel.

FAQ

Next.js 15 or 16?
Both; the rules say which behavior is 16-only (proxy.ts, revalidateTag profiles) and the overview rule tells the agent to check your installed version first.
Is it really free?
Yes, free to use, change and share.
What's in the paid pack?
11 rules covering Server/Client Components, async params, caching and revalidation, Server Actions, Route Handlers, proxy.ts, metadata, next/image, config and error files.
How do I get the files?
Click Download free. The zip downloads straight away: no checkout, no account.
Do I have to sign up for the newsletter?
No. The form is optional and the download works without it.

Get Next.js Cursor Rules Starter (Free)

Free Next.js Cursor rules in .mdc format, checked against current Next.js docs, plus a linter that shows why a rule isn't applying.

Pairs well with

Download$12

Cursor Rules for Django

10 Cursor rules for Django (models and N+1 and more), written against current docs. Installs in one command, exports AGENTS.md. $12 once.

View Cursor Rules for Django
DownloadFree

Django Cursor Rules Starter (Free)

Free Django Cursor rules in .mdc format, checked against current Django docs, plus a linter that shows why a rule isn't applying.

View Django Cursor Rules Starter (Free)
Download$12

Cursor Rules for Rails

9 Cursor rules for Rails (Active Record and more), written against current docs. Installs in one command, exports AGENTS.md. $12 once.

View Cursor Rules for Rails

Related