windsurf-deploy-integration

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 <[e-mail]>
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"