| name | windsurf-deploy-integration |
| description | Deploy applications using Windsurf's built-in deployment features and Cascade automation.
Use when deploying apps from Windsurf, configuring Netlify/Vercel integration,
or building deployment workflows with Cascade.
Trigger with phrases like "deploy windsurf", "windsurf deploy",
"windsurf netlify", "windsurf vercel", "cascade deploy".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(git:*) |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","windsurf","deployment","netlify","vercel"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Windsurf Deploy Integration
Overview
Windsurf offers native deployment integration (starting with Netlify) that lets you deploy directly from the IDE. Combined with Cascade workflows, you can automate the entire build-test-deploy pipeline without leaving the editor.
Prerequisites
- Windsurf Pro plan or higher
- Deployment platform account (Netlify, Vercel, or cloud provider)
- Application ready to deploy
- Git repository configured
Instructions
Step 1: Use Windsurf's Native Deploy (Netlify)
Windsurf has a first-party Netlify integration:
1. Open Cascade (Cmd/Ctrl+L)
2. Prompt: "Deploy this project to Netlify"
3. Cascade runs the build, connects to Netlify, and deploys
4. Preview URL appears in Cascade output
5. Click to verify in browser or use in-IDE Preview
For first-time setup:
Cascade prompt: "Set up Netlify deployment for this Next.js project.
Configure build command, output directory, and environment variables."
Step 2: Create a Deployment Workflow
<!-- .windsurf/workflows/deploy-staging.md -->
---
name: deploy-staging
description: Build, test, and deploy to staging
---
## Pre-Deploy Checks
// turbo-all
1. Run `git status` — abort if uncommitted changes
2. Run `npm run typecheck` — abort if type errors
3. Run `npm test` — abort if test failures
4. Run `npm run lint` — abort if lint errors
## Build and Deploy
5. Run `npm run build`
6. Run `npx netlify deploy --dir=dist --site=$NETLIFY_SITE_ID`
Or: `npx vercel --yes`
## Post-Deploy Verification
7. Run `curl -sf $DEPLOY_URL/health | jq .`
8. Report: deploy URL, build time, health check result
Step 3: Vercel Deployment via Cascade
Cascade prompt: "Deploy this project to Vercel.
- Use the production branch for prod deploys
- Set these environment variables: DATABASE_URL, API_KEY
- Configure custom domain: app.example.com"
