auto_awesome

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

  • check_circleWindsurf merges .windsurfrules with global_rules.md from the user profile
  • check_circlePer-workspace rules live in .windsurf/rules/*.md (newer format)
  • check_circlePlain markdown — no frontmatter
Generate a .windsurfrulesarrow_forwardConvert 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.

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

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