Windsurf (.windsurfrules)

Windsurf reads .windsurfrules from the repo root. Plain markdown — Windsurf treats it as a system-prompt prefix appended to every Cascade interaction.

File path
.windsurfrules
Length cap (recommended)
~500 lines
Frontmatter
No
File globs
No

Format quirks

  • Windsurf merges .windsurfrules with global_rules.md from the user profile
  • Per-workspace rules live in .windsurf/rules/*.md (newer format)
  • Plain markdown — no frontmatter
Generate a .windsurfrulesConvert an existing rules file

Browse stack examples

Every stack page in the library has a one-click copy button for Windsurf (.windsurfrules). Open any of these and pick "Windsurf (.windsurfrules)" from the format dropdown.

Next.js (App Router) + TypeScript
Next.js App Router (TypeScript, Server Components)
Next.js + Supabase (Auth, Postgres, RLS)
Next.js + Prisma + Postgres
React 19 + TypeScript (Vite)
React Native + Expo (managed workflow)
Python + FastAPI + SQLAlchemy + Alembic
Python + Django + DRF
Python + pandas + numpy + scikit-learn (Jupyter)
PyTorch + Hugging Face + W&B
Node.js + Express + TypeScript
Turborepo + pnpm + TypeScript
See all 20 stacks

Official docs: https://docs.codeium.com/windsurf/cascade/rules