@thierrynakoa/fire-flow 12.2.2 → 13.0.1

package/skills-library/deployment-security/VERCEL_GITHUB_DEPLOYMENT_GUIDE.md

@@ -0,0 +1,858 @@
+# Vercel Deployment via GitHub - Complete Guide
+
+**Project:** BoltBudgetApp
+**Repository:** https://github.com/ThierryN/BoltBudgetApp.git
+**Production URL:** https://bolt-budget-app.vercel.app
+**Last Updated:** January 6, 2026
+
+---
+
+## Table of Contents
+
+1. [Overview](#overview)
+2. [Visual Architecture](#visual-architecture)
+3. [Quick Reference Commands](#quick-reference-commands)
+4. [Step-by-Step Deployment](#step-by-step-deployment)
+5. [Branch Strategy](#branch-strategy)
+6. [Common Scenarios](#common-scenarios)
+7. [Troubleshooting](#troubleshooting)
+8. [Environment Variables](#environment-variables)
+
+---
+
+## Overview
+
+### How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                     DEPLOYMENT FLOW                                  │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│   LOCAL MACHINE              GITHUB                 VERCEL           │
+│   ─────────────              ──────                 ──────           │
+│                                                                      │
+│   ┌─────────┐    git push    ┌─────────┐  webhook  ┌─────────┐     │
+│   │  Your   │ ─────────────► │  main   │ ────────► │  Build  │     │
+│   │  Code   │                │ branch  │           │ & Deploy│     │
+│   └─────────┘                └─────────┘           └────┬────┘     │
+│                                                          │          │
+│                                                          ▼          │
+│                                                    ┌─────────┐     │
+│                                                    │ LIVE AT │     │
+│                                                    │ .vercel │     │
+│                                                    │  .app   │     │
+│                                                    └─────────┘     │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### Key Points
+- **Automatic Deployment:** Push to `main` branch triggers deployment
+- **Build Time:** ~1-3 minutes
+- **Preview Deployments:** Every PR gets its own preview URL
+- **Rollback:** Can rollback to any previous deployment in Vercel dashboard
+
+---
+
+## Visual Architecture
+
+### Project Structure
+
+```
+BoltBudgetApp/
+│
+├── src/                    # React source code
+│   ├── components/         # UI components
+│   ├── hooks/              # Custom React hooks
+│   ├── lib/                # Utility functions
+│   └── pages/              # Page components
+│
+├── supabase/
+│   └── functions/          # Edge Functions (deployed separately)
+│       └── ai-agent/       # AI processing function
+│
+├── public/                 # Static assets
+├── package.json            # Dependencies
+├── vite.config.ts          # Vite configuration
+├── vercel.json             # Vercel configuration
+└── .env.local              # Local environment variables (NOT committed)
+```
+
+### Deployment Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│                         YOUR COMPUTER                                │
+│  ┌──────────────────────────────────────────────────────────────┐  │
+│  │                                                               │  │
+│  │   C:\path\to\repos\BoltBudgetApp\                          │  │
+│  │                                                               │  │
+│  │   git add .                                                   │  │
+│  │   git commit -m "message"                                     │  │
+│  │   git push origin main                                        │  │
+│  │                                                               │  │
+│  └───────────────────────────┬──────────────────────────────────┘  │
+│                              │                                      │
+└──────────────────────────────┼──────────────────────────────────────┘
+                               │
+                               │ HTTPS (encrypted)
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│                           GITHUB                                     │
+│  ┌──────────────────────────────────────────────────────────────┐  │
+│  │                                                               │  │
+│  │   Repository: ThierryN/BoltBudgetApp                         │  │
+│  │                                                               │  │
+│  │   Branches:                                                   │  │
+│  │   ├── main (production)          ◄── Triggers Vercel deploy  │  │
+│  │   ├── refining-656-form          ◄── Feature branch          │  │
+│  │   └── [other branches]                                        │  │
+│  │                                                               │  │
+│  └───────────────────────────┬──────────────────────────────────┘  │
+│                              │                                      │
+└──────────────────────────────┼──────────────────────────────────────┘
+                               │
+                               │ Webhook (automatic)
+                               ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│                           VERCEL                                     │
+│  ┌──────────────────────────────────────────────────────────────┐  │
+│  │                                                               │  │
+│  │   1. Receives webhook from GitHub                            │  │
+│  │   2. Clones repository                                        │  │
+│  │   3. Runs: npm install                                        │  │
+│  │   4. Runs: npm run build                                      │  │
+│  │   5. Deploys to CDN edge network                             │  │
+│  │                                                               │  │
+│  │   Production URL: https://bolt-budget-app.vercel.app         │  │
+│  │                                                               │  │
+│  └──────────────────────────────────────────────────────────────┘  │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Visual Studio Code Git Integration
+
+### Using VS Code Instead of Command Line
+
+VS Code has built-in Git support. Here's how to deploy without using terminal:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    VS CODE GIT PANEL                                 │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│   Location: Left sidebar → Source Control icon (branch symbol)      │
+│   Keyboard Shortcut: Ctrl + Shift + G                               │
+│                                                                      │
+│   ┌─────────────────────────────────────────────────────────────┐  │
+│   │  SOURCE CONTROL                                    ≡  ↻  ⋮  │  │
+│   ├─────────────────────────────────────────────────────────────┤  │
+│   │                                                              │  │
+│   │  Message (Ctrl+Enter to commit)                             │  │
+│   │  ┌────────────────────────────────────────────────────────┐ │  │
+│   │  │ fix: Your commit message here                          │ │  │
+│   │  └────────────────────────────────────────────────────────┘ │  │
+│   │                                                              │  │
+│   │  ┌──────────────────────────────────────────────────────┐   │  │
+│   │  │              ✓ Commit (Ctrl+Enter)                   │   │  │
+│   │  └──────────────────────────────────────────────────────┘   │  │
+│   │                                                              │  │
+│   │  Changes                                              2 ▼   │  │
+│   │    M  src/components/Terms/TermsAcceptanceWizard.tsx       │  │
+│   │    M  src/lib/aiProviders.ts                               │  │
+│   │                                                              │  │
+│   └─────────────────────────────────────────────────────────────┘  │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### VS Code Step-by-Step Deployment
+
+**Step 1: Open Source Control Panel**
+```
+Keyboard: Ctrl + Shift + G
+   - or -
+Click the branch icon in left sidebar (3rd icon from top)
+```
+
+**Step 2: Review Changes**
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  In the "Changes" section, you'll see modified files:               │
+│                                                                      │
+│  Changes                                                      2     │
+│    M  src/components/Terms/TermsWizard.tsx    ← M = Modified        │
+│    U  src/newfile.tsx                         ← U = Untracked (new) │
+│    D  src/deletedfile.tsx                     ← D = Deleted         │
+│                                                                      │
+│  Click any file to see the diff (changes highlighted)              │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**Step 3: Stage Changes**
+```
+Option A: Stage ALL changes
+  - Click the "+" icon next to "Changes" header
+
+Option B: Stage individual files
+  - Hover over each file
+  - Click the "+" icon that appears
+
+┌─────────────────────────────────────────────────────────────────────┐
+│  Changes                                              [+] [-] [↺]   │
+│    M  src/file.tsx                                    [+] hover     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**Step 4: Write Commit Message**
+```
+Type in the message box at the top:
+
+┌────────────────────────────────────────────────────────────────────┐
+│  fix: Description of what you fixed                                │
+└────────────────────────────────────────────────────────────────────┘
+
+Good commit messages:
+  ✓ fix: Terms wizard scroll not working on mobile
+  ✓ feat: Add dark mode toggle
+  ✓ docs: Update README with new instructions
+```
+
+**Step 5: Commit**
+```
+Option A: Press Ctrl + Enter
+Option B: Click the checkmark (✓) button
+Option C: Click "Commit" button
+```
+
+**Step 6: Push to GitHub (Deploy)**
+```
+After committing, you'll see:
+
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│  ┌──────────────────────────────────────────────────────────────┐  │
+│  │              Sync Changes  1↑                                │  │
+│  └──────────────────────────────────────────────────────────────┘  │
+│                                                                      │
+│  The "1↑" means 1 commit ready to push                             │
+│                                                                      │
+│  Click "Sync Changes" to push to GitHub                            │
+│  (This triggers Vercel deployment!)                                │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+
+Alternative: Click "..." menu → Push
+```
+
+**Step 7: Verify in Status Bar**
+```
+Look at bottom-left of VS Code:
+
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│  ◯ main ↑0 ↓0    ← This means synced with GitHub                   │
+│                                                                      │
+│  ◯ main ↑1 ↓0    ← 1 commit to push (not yet pushed)               │
+│                                                                      │
+│  ◯ main ↑0 ↓2    ← 2 commits to pull from GitHub                   │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### VS Code Keyboard Shortcuts for Git
+
+| Action | Shortcut | Description |
+|--------|----------|-------------|
+| Open Source Control | `Ctrl + Shift + G` | Opens Git panel |
+| Stage All Changes | - | Click + next to Changes |
+| Commit | `Ctrl + Enter` | Commits staged changes |
+| Open Terminal | `` Ctrl + ` `` | For command line if needed |
+| Command Palette | `Ctrl + Shift + P` | Type "Git:" for all commands |
+
+### VS Code Git Commands via Command Palette
+
+Press `Ctrl + Shift + P` and type:
+```
+Git: Stage All Changes
+Git: Commit
+Git: Push
+Git: Pull
+Git: Sync
+Git: Checkout to...
+Git: Create Branch...
+```
+
+### Visual Guide: Complete VS Code Workflow
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│   1. OPEN SOURCE CONTROL                                            │
+│      Press: Ctrl + Shift + G                                        │
+│                    │                                                 │
+│                    ▼                                                 │
+│   2. REVIEW CHANGES                                                 │
+│      Click files to see what changed                                │
+│                    │                                                 │
+│                    ▼                                                 │
+│   3. STAGE CHANGES                                                  │
+│      Click [+] next to "Changes"                                    │
+│                    │                                                 │
+│                    ▼                                                 │
+│   4. WRITE MESSAGE                                                  │
+│      Type: "fix: Your description"                                  │
+│                    │                                                 │
+│                    ▼                                                 │
+│   5. COMMIT                                                         │
+│      Press: Ctrl + Enter                                            │
+│                    │                                                 │
+│                    ▼                                                 │
+│   6. PUSH (DEPLOY!)                                                 │
+│      Click: "Sync Changes" button                                   │
+│                    │                                                 │
+│                    ▼                                                 │
+│   7. DONE!                                                          │
+│      Wait 1-3 min, then check:                                      │
+│      https://bolt-budget-app.vercel.app                            │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Quick Reference Commands
+
+### Essential Git Commands for BoltBudgetApp
+
+```bash
+# ═══════════════════════════════════════════════════════════════════
+#                    DAILY WORKFLOW COMMANDS
+# ═══════════════════════════════════════════════════════════════════
+
+# 1. CHECK STATUS - Always start here
+git status
+
+# 2. SEE WHAT CHANGED
+git diff
+
+# 3. STAGE ALL CHANGES
+git add .
+
+# 4. COMMIT WITH MESSAGE
+git commit -m "fix: Description of what you fixed"
+
+# 5. PUSH TO GITHUB (triggers Vercel deployment)
+git push origin main
+
+# ═══════════════════════════════════════════════════════════════════
+#                    BRANCH COMMANDS
+# ═══════════════════════════════════════════════════════════════════
+
+# See all branches
+git branch -a
+
+# Switch to main branch
+git checkout main
+
+# Create new feature branch
+git checkout -b feature/new-feature-name
+
+# Push feature branch to GitHub
+git push origin feature/new-feature-name
+
+# Merge feature branch to main
+git checkout main
+git merge feature/new-feature-name
+git push origin main
+
+# ═══════════════════════════════════════════════════════════════════
+#                    VIEWING HISTORY
+# ═══════════════════════════════════════════════════════════════════
+
+# See recent commits
+git log --oneline -10
+
+# See commits with details
+git log -5
+
+# See what's on remote
+git log origin/main --oneline -5
+```
+
+### Copy-Paste Commands (Windows PowerShell)
+
+```powershell
+# ═══════════════════════════════════════════════════════════════════
+#                    COMPLETE DEPLOYMENT SEQUENCE
+# ═══════════════════════════════════════════════════════════════════
+
+# Navigate to project
+cd C:\path\to\repos\BoltBudgetApp
+
+# Check current state
+git status
+
+# Stage all changes
+git add .
+
+# Commit (replace message with your description)
+git commit -m "fix: Your fix description here"
+
+# Push to main (THIS TRIGGERS VERCEL DEPLOYMENT)
+git push origin main
+
+# Verify push succeeded
+git log origin/main --oneline -3
+```
+
+---
+
+## Step-by-Step Deployment
+
+### Scenario: Deploy a Bug Fix
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    DEPLOYMENT CHECKLIST                              │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│   □ Step 1: Open Terminal/PowerShell                                │
+│   □ Step 2: Navigate to project folder                              │
+│   □ Step 3: Check git status                                        │
+│   □ Step 4: Stage changes (git add .)                               │
+│   □ Step 5: Commit with descriptive message                         │
+│   □ Step 6: Push to main branch                                     │
+│   □ Step 7: Wait 1-3 minutes for Vercel                             │
+│   □ Step 8: Test at https://bolt-budget-app.vercel.app              │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### Detailed Steps
+
+**Step 1: Open Terminal**
+```
+Windows: Press Win + X, select "Windows Terminal" or "PowerShell"
+```
+
+**Step 2: Navigate to Project**
+```powershell
+cd C:\path\to\repos\BoltBudgetApp
+```
+
+**Step 3: Check What Changed**
+```powershell
+git status
+```
+
+Expected output:
+```
+On branch main
+Changes not staged for commit:
+  modified:   src/components/SomeFile.tsx
+```
+
+**Step 4: Stage Changes**
+```powershell
+git add .
+```
+
+**Step 5: Commit**
+```powershell
+git commit -m "fix: Brief description of what was fixed"
+```
+
+Commit message prefixes:
+- `fix:` - Bug fixes
+- `feat:` - New features
+- `docs:` - Documentation
+- `style:` - Formatting changes
+- `refactor:` - Code restructuring
+
+**Step 6: Push to GitHub**
+```powershell
+git push origin main
+```
+
+Expected output:
+```
+Enumerating objects: 5, done.
+Counting objects: 100% (5/5), done.
+Writing objects: 100% (3/3), 450 bytes | 450.00 KiB/s, done.
+To https://github.com/ThierryN/BoltBudgetApp.git
+   abc1234..def5678  main -> main
+```
+
+**Step 7: Wait for Vercel**
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│   Vercel Build Process (1-3 minutes):                               │
+│                                                                      │
+│   [████████████████████░░░░░░░░░░] 60%  Installing dependencies...  │
+│   [████████████████████████████░░] 90%  Building...                 │
+│   [██████████████████████████████] 100% Deploying...                │
+│                                                                      │
+│   ✓ Production deployment ready!                                    │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**Step 8: Test**
+- Open browser: https://bolt-budget-app.vercel.app
+- Hard refresh: Ctrl + Shift + R (Windows) or Cmd + Shift + R (Mac)
+
+---
+
+## Branch Strategy
+
+### Visual Branch Flow
+
+```
+main ─────●─────●─────●─────●─────●─────●───► Production
+           \         /       \         /
+            \       /         \       /
+feature-1 ───●─────●           \     /
+                                \   /
+feature-2 ──────────────────────●───●
+```
+
+### Working with Feature Branches
+
+```powershell
+# ═══════════════════════════════════════════════════════════════════
+#                    FEATURE BRANCH WORKFLOW
+# ═══════════════════════════════════════════════════════════════════
+
+# 1. Start from main
+git checkout main
+git pull origin main
+
+# 2. Create feature branch
+git checkout -b feature/my-new-feature
+
+# 3. Make changes and commit
+git add .
+git commit -m "feat: Add new feature"
+
+# 4. Push feature branch
+git push origin feature/my-new-feature
+
+# 5. When ready, merge to main
+git checkout main
+git merge feature/my-new-feature
+
+# 6. Push main (deploys to Vercel)
+git push origin main
+
+# 7. Delete feature branch (optional)
+git branch -d feature/my-new-feature
+git push origin --delete feature/my-new-feature
+```
+
+### Current Project Branches
+
+| Branch | Purpose | Deploys To |
+|--------|---------|------------|
+| `main` | Production code | bolt-budget-app.vercel.app |
+| `refining-656-form` | Form 656 improvements | Preview URL |
+| `CleanupBranch` | Code cleanup | Preview URL |
+
+---
+
+## Common Scenarios
+
+### Scenario 1: Quick Bug Fix
+
+```powershell
+# One-liner for quick fixes
+cd C:\path\to\repos\BoltBudgetApp && git add . && git commit -m "fix: Quick bug fix" && git push origin main
+```
+
+### Scenario 2: Push Feature Branch AND Main
+
+```powershell
+# Push to both (updates feature branch and deploys to production)
+git push origin refining-656-form && git push origin refining-656-form:main
+```
+
+### Scenario 3: Undo Last Commit (Before Push)
+
+```powershell
+# Undo commit but keep changes
+git reset --soft HEAD~1
+
+# Now you can re-commit with different message
+git commit -m "fix: Better commit message"
+```
+
+### Scenario 4: See Vercel Build Status
+
+```
+1. Go to: https://vercel.com/dashboard
+2. Find project: BoltBudgetApp
+3. Click to see deployments
+4. Each deployment shows:
+   - Status (Building, Ready, Error)
+   - Commit message
+   - Preview URL
+```
+
+### Scenario 5: Rollback to Previous Version
+
+```
+Via Vercel Dashboard:
+1. Go to project deployments
+2. Find the working deployment
+3. Click "..." menu
+4. Select "Promote to Production"
+```
+
+---
+
+## Troubleshooting
+
+### Problem: "Permission denied" on push
+
+```powershell
+# Check your Git credentials
+git config --global user.name
+git config --global user.email
+
+# If wrong, set them:
+git config --global user.name "ThierryN"
+git config --global user.email "your-email@example.com"
+```
+
+### Problem: "Merge conflict"
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    MERGE CONFLICT RESOLUTION                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│   1. Open the conflicting file                                      │
+│                                                                      │
+│   2. Look for conflict markers:                                     │
+│      <<<<<<< HEAD                                                   │
+│      your changes                                                   │
+│      =======                                                        │
+│      their changes                                                  │
+│      >>>>>>> branch-name                                            │
+│                                                                      │
+│   3. Keep the code you want, delete the markers                     │
+│                                                                      │
+│   4. Save file                                                      │
+│                                                                      │
+│   5. Stage and commit:                                              │
+│      git add .                                                      │
+│      git commit -m "fix: Resolve merge conflict"                    │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### Problem: Vercel build fails
+
+```powershell
+# Test build locally first
+cd C:\path\to\repos\BoltBudgetApp
+npm run build
+
+# If errors, fix them before pushing
+# Common fixes:
+# - TypeScript errors
+# - Missing dependencies
+# - Environment variables not set
+```
+
+### Problem: Changes not showing on website
+
+```
+1. Wait 2-3 minutes (build takes time)
+2. Hard refresh browser: Ctrl + Shift + R
+3. Clear browser cache
+4. Check Vercel dashboard for build status
+5. Check if you pushed to correct branch (main)
+```
+
+---
+
+## Environment Variables
+
+### Where Environment Variables Are Set
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    ENVIRONMENT VARIABLE LOCATIONS                    │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│   LOCAL DEVELOPMENT                                                  │
+│   ─────────────────                                                  │
+│   File: C:\path\to\repos\BoltBudgetApp\.env.local                 │
+│   NOT committed to Git (in .gitignore)                              │
+│                                                                      │
+│   VERCEL (PRODUCTION)                                               │
+│   ───────────────────                                               │
+│   Set via: Vercel Dashboard → Project → Settings → Environment     │
+│   Variables                                                          │
+│                                                                      │
+│   SUPABASE EDGE FUNCTIONS                                           │
+│   ───────────────────────                                           │
+│   Set automatically by Supabase                                     │
+│   - SUPABASE_URL                                                    │
+│   - SUPABASE_SERVICE_ROLE_KEY                                       │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### Required Environment Variables
+
+| Variable | Where | Purpose |
+|----------|-------|---------|
+| `VITE_SUPABASE_URL` | Vercel & .env.local | Supabase project URL |
+| `VITE_SUPABASE_ANON_KEY` | Vercel & .env.local | Supabase anonymous key |
+
+### Setting Variables in Vercel
+
+```
+1. Go to: https://vercel.com/dashboard
+2. Select project: BoltBudgetApp
+3. Click: Settings (tab)
+4. Click: Environment Variables (left menu)
+5. Add each variable:
+   - Name: VITE_SUPABASE_URL
+   - Value: https://ovigezezdnacnhxhtsbx.supabase.co
+   - Environment: Production, Preview, Development
+6. Click: Save
+7. Redeploy for changes to take effect
+```
+
+---
+
+## Quick Command Card
+
+```
+╔═══════════════════════════════════════════════════════════════════╗
+║                    GIT DEPLOYMENT CHEAT SHEET                      ║
+╠═══════════════════════════════════════════════════════════════════╣
+║                                                                    ║
+║   CHECK STATUS        git status                                   ║
+║   SEE CHANGES         git diff                                     ║
+║   STAGE ALL           git add .                                    ║
+║   COMMIT              git commit -m "message"                      ║
+║   PUSH (DEPLOY)       git push origin main                         ║
+║   VIEW LOG            git log --oneline -10                        ║
+║                                                                    ║
+║   ─────────────────────────────────────────────────────────────    ║
+║                                                                    ║
+║   FULL DEPLOY SEQUENCE (copy/paste):                               ║
+║                                                                    ║
+║   cd C:\path\to\repos\BoltBudgetApp                             ║
+║   git add .                                                        ║
+║   git commit -m "fix: Description"                                 ║
+║   git push origin main                                             ║
+║                                                                    ║
+║   ─────────────────────────────────────────────────────────────    ║
+║                                                                    ║
+║   PRODUCTION URL: https://bolt-budget-app.vercel.app              ║
+║   GITHUB REPO: https://github.com/ThierryN/BoltBudgetApp          ║
+║   VERCEL DASHBOARD: https://vercel.com/dashboard                  ║
+║                                                                    ║
+╚═══════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Supabase Edge Functions (Separate Deployment)
+
+Edge Functions are NOT deployed via Vercel. They require separate deployment.
+
+### Edge Function Deployment Commands
+
+```powershell
+# Navigate to project
+cd C:\path\to\repos\BoltBudgetApp
+
+# Login to Supabase (one-time)
+npx supabase login
+
+# Link project (one-time)
+npx supabase link --project-ref ovigezezdnacnhxhtsbx
+
+# Deploy all functions
+npx supabase functions deploy
+
+# Deploy specific function
+npx supabase functions deploy ai-agent
+```
+
+### When to Deploy Edge Functions
+
+Deploy Edge Functions when you modify files in:
+```
+supabase/functions/
+├── ai-agent/
+│   └── index.ts    ← If this changes, deploy Edge Function
+```
+
+---
+
+## Summary Flowchart
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                                                                      │
+│   START: Made code changes                                          │
+│          │                                                          │
+│          ▼                                                          │
+│   ┌─────────────┐                                                   │
+│   │ git status  │  ← See what changed                               │
+│   └──────┬──────┘                                                   │
+│          │                                                          │
+│          ▼                                                          │
+│   ┌─────────────┐                                                   │
+│   │  git add .  │  ← Stage changes                                  │
+│   └──────┬──────┘                                                   │
+│          │                                                          │
+│          ▼                                                          │
+│   ┌─────────────────────────┐                                       │
+│   │ git commit -m "message" │  ← Save changes locally               │
+│   └───────────┬─────────────┘                                       │
+│               │                                                      │
+│               ▼                                                      │
+│   ┌───────────────────────┐                                         │
+│   │ git push origin main  │  ← Push to GitHub                       │
+│   └───────────┬───────────┘                                         │
+│               │                                                      │
+│               │  (automatic)                                        │
+│               ▼                                                      │
+│   ┌───────────────────────┐                                         │
+│   │   VERCEL BUILDS &     │  ← Wait 1-3 minutes                     │
+│   │      DEPLOYS          │                                         │
+│   └───────────┬───────────┘                                         │
+│               │                                                      │
+│               ▼                                                      │
+│   ┌───────────────────────┐                                         │
+│   │ LIVE AT:              │                                         │
+│   │ bolt-budget-app       │  ← Test your changes!                   │
+│   │ .vercel.app           │                                         │
+│   └───────────────────────┘                                         │
+│                                                                      │
+│   END: Changes are live                                             │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+**Document Created:** January 6, 2026
+**Author:** Claude AI (WARRIOR Workflow)
+**For:** Plugin Owner - Project