Supabase Cursor Rules Starter (Free)

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

Supabase Cursor Rules Starter (Free) cover

What it is

3 Cursor project rules for Supabase 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 Supabase Cursor Rules Starter: demo and passing tests

The rules (in .cursor/rules/)

RuleLoadsFirst instruction
supabase-overview.mdcalwaysKeys: the publishable key (sb_publishable_...) is for anything shipped to users and only reaches what Row Level...
supabase-rls-policies.mdcby file (supabase/migrations//*.sql, supabase//*.sql)alter table x enable row level security; in the same migration that creates the table
supabase-ssr-auth.mdcby file (utils/supabase/, lib/supabase/, src/lib/supabase/, proxy.ts, middleware.ts, app/auth/)Use @supabase/ssr (createBrowserClient, createServerClient)

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, 11 KB, v1.0, 17 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 Supabase.

FAQ

Only Next.js?
The RLS, migrations, Storage, Realtime and Edge Function rules work with any frontend; the SSR auth rule covers @supabase/ssr frameworks.
Is it really free?
Yes, free to use, change and share.
What's in the paid pack?
8 rules covering Row Level Security policies, @supabase/ssr auth, CLI migrations, typed queries, Edge Functions, Storage and Realtime.
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 Supabase Cursor Rules Starter (Free)

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

Pairs well with

Download$29

Cursor Rules Stack Bundle

59 Cursor rules: Next.js 16, Django, Rails 8, Supabase and general rules for TypeScript, Python, Go and more. Detects each repo's stack. $29 once, $60 value.

View Cursor Rules Stack Bundle
Download$29

SEO Audit MCP Server

SEO MCP server for Claude Code, Cursor and Claude Desktop: page audits, redirect chains, robots.txt, sitemaps and site crawls. No API keys or credits. $29 once.

View SEO Audit MCP Server
Download$12

Cursor Rules for Laravel

8 Cursor rules for Laravel, written against current docs. Installs in one command, exports AGENTS.md for Claude Code and Codex. $12 once.

View Cursor Rules for Laravel

Related