Ai coding tool guides

Windsurf

Windsurf (by Codeium) is an AI-native code editor designed for collaborative AI-assisted development. Like Cursor, it's a local editor, so your projects live on your machine with full Git support.

Connecting via GitHub

Step 1: Push your project to GitHub

Use Windsurf's built-in source control panel or the terminal:

cd your-project
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/your-username/your-repo.git
git push -u origin main

You can also use Windsurf's Source Control sidebar to stage, commit, and push — it works the same as VS Code's Git integration.

Step 2: Connect the repo in Lunadeck

1. In the Lunadeck dashboard, click Start a new project
2. Select Connect Git Repository
3. Authorize Lunadeck to access your GitHub account
4. Select your repository
5. Click Import

Step 3: Build

Click Build to compile your project into a native mobile app.

Exporting as a ZIP archive

Step 1: Create a ZIP from your local project

# Exclude dependencies and build output
zip -r my-project.zip . -x "node_modules/*" ".git/*" "dist/*" "build/*"

On macOS, you can also right-click the project folder in Finder and select Compress. On Windows, right-click and select Send to → Compressed (zipped) folder. Remember to delete node_modules first.

Step 2: Upload to Lunadeck

1. In the Lunadeck dashboard, click Start a new project
2. Select Upload a ZIP
3. Drag and drop the ZIP file or click to browse
4. Click Import

Tips

• Cascade-generated code — Windsurf's Cascade AI agent can generate entire project structures. Review the generated package.json to ensure all dependencies are correct before building
• Use Git integration — connecting via GitHub enables automatic rebuilds whenever you push changes, which pairs well with Windsurf's iterative AI workflow