Browse and preview all 610+ Windsurf templates for free. Copy any template, and every Windsurf setup file on this page, with a BrowserMoon licence.
Get a licenceDesign help before you prompt Windsurf
Ask Mon, the AI design assistant, which layout and template fit your app. Then paste it into Windsurf.
What are Windsurf templates?
Windsurf templates are finished UI designs you add to your project for Cascade to follow. Save a template in your repo, mention it with @, and add the Windsurf rules template from this page so every Cascade session builds to the same design.
How to use templates with Windsurf
Save the template in your project
Copy a template and save it as design/template.html.
Add the rules file
Save the Windsurf rules template from this page in .windsurf/rules.
Mention it in Cascade
Ask Cascade for the page and mention @design/template.html.
Check the preview
Open the preview after each change and point out anything that does not match.
Windsurf rules template for design
Windsurf rules are read by Cascade in every session. This one keeps colours, spacing and components consistent across the project.
Windsurf design rules template
A Windsurf rules file that Cascade follows in every session, so pages it builds match your template and reuse your components.
.windsurf/rules/design.md# Design rules (apply to all UI work) Follow @design/template.html for every page and component. ## Design source of truth - Match the BrowserMoon template in design/template.html for fonts, spacing, colours, corner radius, shadows and components. When in doubt, open it and copy what it does. - Never invent a new style. If something is not in the template, use the closest thing that is.
Free logo, app icon and favicon for your Windsurf app
Still showing the default icon? Pick a free SVG logo, then make a matching app icon, favicon, social share image and App Store screenshot with the free app launch kit. Drop the files in your Windsurf project's public folder. If the rest of the app still looks default, read why AI apps look generic.
Why Cascade needs a fixed design
Cascade can change many files from one prompt, which is powerful and also how designs drift: every change is a chance for a new shade of grey. A template and a rules file give it one design to return to, on every page.
Windsurf templates for websites and apps
Start with the page that sets the tone. For a SaaS, that is the landing page or the main dashboard; for a portfolio, the home page. Cascade copies its fonts, colours and spacing into the components it creates, and every later page reuses them.
Hero, landing page and dashboard templates suit Windsurf best, because Cascade can turn one template into a full set of components in a single run. Add pricing, settings and login pages next, each with its own prompt.
Windsurf vs Cursor for building from a template
Both read a template file you mention with @, and both follow a rules file. Cascade tends to take bigger steps across many files at once, while Cursor Agent is often used for smaller, reviewed changes. With a template and a rules file, either one builds pages that match. There is a Cursor version of the rules file on the Cursor templates page.
Who uses Windsurf templates
Windsurf templates are used by developers who like Cascade's ability to change many files at once: building a full marketing site from one template, converting a design into a component library, or adding a set of app screens in one go. A fixed design keeps those large changes consistent.
Best Windsurf templates by use case
Landing page template for Windsurf
Cascade turns one template into a full set of section components in one run.
Hero section template for Windsurf
A strong first screen for a Next.js or Astro marketing site.
Dashboard template for Windsurf
Charts and tables Cascade wires to your data across several files.
Navigation template for Windsurf
A navigation bar with mobile menu, matched to the rest of the site.
Pricing template for Windsurf
A pricing section that matches the template's type and spacing.
Tips for better results in Windsurf
Mention files with @
Point Cascade at the template file instead of pasting it.
Use Write mode for builds
Let Cascade create and edit files, then review the summary.
Keep rules short
A focused design rule is followed more reliably than a long one.
Check the preview
Use the built-in preview after each change and point out differences.
Windsurf vs Cursor
In practice, many developers try both and keep the editor whose agent they trust on their codebase. Whichever you choose, the same template file and a short rules file are what keep the UI consistent from one session to the next.
Windsurf and Cursor both read templates with @ and follow rules files. Cascade is built for larger multi-file steps, and Cursor Agent for reviewed changes. With a template and a design rule, either keeps the UI consistent; the Cursor rules template on the Cursor page uses the same structure as the Windsurf one here.
What to ask Windsurf after you paste a template
- @design/template.html build the landing page as section components.
- Add a pricing section that matches the hero's type and spacing.
- Check this page at 375px and fix anything that overflows.
- Replace raw colours in these files with our theme tokens.
Common mistakes with Windsurf templates
Pasting the template into chat
Mention the file with @ instead.
No rules file
Add the design rule so every Cascade session follows the template.
Accepting large changes unread
Read Cascade's summary and the diff before keeping changes.
Windsurf templates by section
Windsurf templates by framework
Frequently asked questions
What are Windsurf templates?
Finished UI designs you add to your project for Cascade to follow, plus a rules file that keeps every session on design.
How do I use a template in Windsurf?
Save it in your repo and mention it with @ when you ask Cascade to build a page.
Where do Windsurf rules go?
In your workspace rules, in the .windsurf/rules folder. Cascade reads them in every session.
Are the Windsurf templates free?
Browsing and previewing are free. Copying needs a BrowserMoon licence.
Do Windsurf templates work with React and Next.js?
Yes. Cascade converts the HTML template into components for your framework.
Can I use the same template in Cursor?
Yes. The template is plain HTML and CSS, so it works in any AI coding tool.
Can I use Windsurf templates offline?
The templates are plain files in your project, so they work wherever Windsurf runs; only the AI model needs a connection.
How do I add a Windsurf rule?
Create a markdown file in the .windsurf/rules folder of your project with the rule text. The design rules template on this page is ready to save there.
Can Windsurf build a full site from one template?
Yes. Ask Cascade to split the template into sections and pages; it can create several files in one run while keeping the same design.
Do Windsurf templates work with Next.js and Astro?
Yes. Cascade converts the HTML and CSS into components for your framework.
Can Cascade keep my existing components?
Yes. Ask it to reuse them and add that rule to the Windsurf rules file.
Are these templates different from Windsurf's own starters?
Yes. These are finished designs for the UI; Windsurf's starters set up project code. Use both together.
Templates for other AI coding tools