firefrost-operations-manual/docs/code-server-deployment-plan-FINAL.md

# 🔥❄️ CODE-SERVER DEPLOYMENT PLAN (FINAL)

**Date:** February 10, 2026  
**Server:** Command Center VPS (63.143.34.217)  
**URL:** code.firefrostgaming.com  
**Status:** Ready for deployment tonight

**Decisions finalized after Gemini brainstorming sessions review**

---

## DEPLOYMENT OVERVIEW

**What:** Browser-based VS Code (Code-Server)  
**Why:** Accessibility enhancement for hand limitations  
**Goal:** 90% reduction in terminal-based documentation work

**Success Criteria:**
- ✅ HTTPS access working
- ✅ File editing in browser
- ✅ Git operations via GUI
- ✅ Mobile responsive (S24 Ultra + Chromebook)
- ✅ One-handed workflow optimized

---

## FINALIZED SETTINGS

### settings.json
```json
{
  "files.autoSave": "onFocusChange",
  "editor.fontSize": 18,
  "editor.wordWrap": "on",
  "editor.minimap.enabled": false,
  "workbench.editor.restoreViewState": true,
  "explorer.confirmDelete": true,
  "explorer.confirmDragAndDrop": false,
  "git.confirmSync": true,
  "git.autofetch": true,
  "git.enableSmartCommit": true,
  "editor.formatOnSave": true,
  "workbench.colorTheme": "Default Dark+",
  "files.trimTrailingWhitespace": true,
  "editor.lineNumbers": "on",
  "editor.renderWhitespace": "boundary",
  "workbench.startupEditor": "none",
  "terminal.integrated.fontSize": 18,
  "breadcrumbs.enabled": true,
  "workbench.sideBar.location": "right",
  "explorer.compactFolders": false
}
```

**Key Decisions:**
- Font size: 18 (mobile readability)
- Delete confirmation: ENABLED (safety first)
- Git sync confirmation: ENABLED initially (disable after 1 week)
- Sidebar: RIGHT side (thumb-optimized for S24 Ultra)

---

## EXTENSIONS DEPLOYMENT (STAGED)

### Tonight (Core Tier)

1. **Markdown All in One** - Essential formatting automation
2. **Git Graph** - Visual Git workflow
3. **GitLens** - Inline blame/history
4. **vscode-icons** - Mobile navigation aid

### Tomorrow (Enhanced Tier)

5. **Markdown Preview Enhanced** - Side-by-side preview
6. **Error Lens** - Inline error display
7. **Markdown Lint** - Format checking
8. **Prettier** - Auto-formatting
9. **Todo Tree** - Task tracking
10. **Path Intellisense** - Autocomplete paths

**Rationale:** Verify core functionality tonight, add enhancements tomorrow

---

## KEYBINDINGS
```json
[
  {
    "key": "ctrl+\\",
    "command": "workbench.action.toggleSidebarVisibility"
  },
  {
    "key": "alt+z",
    "command": "editor.action.toggleWordWrap"
  },
  {
    "key": "ctrl+q",
    "command": "workbench.action.toggleSidebarVisibility"
  }
]
```

**Accessibility focus:** One-handed shortcuts, no complex chord combinations

---

## MOBILE OPTIMIZATION

### Samsung S24 Ultra
```json
{
  "window.zoomLevel": 0.5,
  "workbench.sideBar.location": "right",
  "explorer.compactFolders": false,
  "breadcrumbs.enabled": true,
  "editor.tabSize": 2
}
```

### Chromebook
```json
{
  "window.zoomLevel": 1,
  "workbench.touchBar.enabled": true
}
```

### PWA Installation

1. Chrome → code.firefrostgaming.com
2. Menu → "Install Code-Server"
3. Home screen icon
4. Launch = fullscreen native app

**Benefit:** 15% more vertical screen space

---

## GIT WORKFLOW (GUI-FIRST)

### Visual Commit Process

1. **Source Control** tab (`Ctrl+Shift+G`)
2. Click **+** to stage all changes
3. Type commit message (or use snippet)
4. Click **✓** to commit
5. Click **Sync** icon to push

### Branch Management

1. Open **Git Graph** from status bar
2. Right-click branch operations
3. Visual merge/rebase
4. No terminal needed

---

## SNIPPET LIBRARY

### Git Commit
```json
"Firefrost Git Commit": {
  "prefix": "ffcommit",
  "body": [
    "${1|Docs,Feature,Fix,Refactor,Deploy|}: $2",
    "",
    "${3:Detailed description}",
    "",
    "Date: $CURRENT_YEAR-$CURRENT_MONTH_NAME-$CURRENT_DATE",
    "Author: Frostystyle"
  ]
}
```

### Session Journal
```json
"Firefrost Session Header": {
  "prefix": "ffsession",
  "body": [
    "# 🔥❄️ FIREFROST SESSION: $CURRENT_MONTH_NAME $CURRENT_DATE, $CURRENT_YEAR",
    "",
    "**Duration:** ${1:Start} - ${2:End}",
    "**Focus:** $3",
    "**Status:** ${4|In Progress,Complete,Paused|}",
    "",
    "---",
    "",
    "## Accomplished",
    "",
    "- $5",
    "",
    "## Next Steps",
    "",
    "- [ ] $6"
  ]
}
```

### Documentation Header
```json
"Firefrost Doc Header": {
  "prefix": "ffdoc",
  "body": [
    "# $1",
    "",
    "**Version:** ${2:1.0}",
    "**Created:** $CURRENT_YEAR-$CURRENT_MONTH_NAME-$CURRENT_DATE",
    "**Author:** Frostystyle",
    "**Status:** ${3|Draft,Review,Final|}",
    "",
    "---",
    "",
    "$4"
  ]
}
```

---

## DEPLOYMENT STEPS

### 1. Install Code-Server
```bash
curl -fsSL https://code-server.dev/install.sh | sh
```

### 2. Configure
```bash
mkdir -p ~/.config/code-server
nano ~/.config/code-server/config.yaml
```
```yaml
bind-addr: 127.0.0.1:8080
auth: password
password: [SECURE_PASSWORD]
cert: false
```

### 3. Create systemd Service
```bash
sudo nano /etc/systemd/system/code-server.service
```
```ini
[Unit]
Description=Code-Server
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/firefrost-work/firefrost-operations-manual
ExecStart=/usr/bin/code-server --bind-addr 127.0.0.1:8080
Restart=always

[Install]
WantedBy=multi-user.target
```

### 4. Enable and Start
```bash
sudo systemctl daemon-reload
sudo systemctl enable code-server
sudo systemctl start code-server
sudo systemctl status code-server
```

### 5. Nginx Reverse Proxy
```bash
sudo nano /etc/nginx/sites-available/code-server.conf
```
```nginx
server {
    listen 80;
    server_name code.firefrostgaming.com;
    
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection upgrade;
        proxy_set_header Accept-Encoding gzip;
    }
}
```
```bash
sudo ln -s /etc/nginx/sites-available/code-server.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
```

### 6. SSL Certificate
```bash
sudo certbot --nginx -d code.firefrostgaming.com
```

### 7. Firewall
```bash
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload
```

### 8. Verify
```bash
curl -I https://code.firefrostgaming.com
```

---

## POST-DEPLOYMENT TASKS

### Immediate (Tonight)

- [ ] Install core extensions
- [ ] Apply settings.json
- [ ] Configure keybindings
- [ ] Create snippet library
- [ ] Test Git GUI workflow
- [ ] Test from desktop browser
- [ ] Test from Chromebook
- [ ] Test from S24 Ultra

### This Week

- [ ] Install enhanced extensions
- [ ] Set up PWA on mobile devices
- [ ] Configure Espanso text expansion
- [ ] Program mouse thumb buttons
- [ ] Install Cockpit web admin
- [ ] Install Stretchly break reminders

### Next Week

- [ ] Train Meg on Code-Server usage
- [ ] Test Gemini → Code-Server workflow
- [ ] Optimize workspace based on usage
- [ ] Document lessons learned

---

## ACCESSIBILITY ENHANCEMENTS (THIS WEEK)

### Espanso Text Expansion

**Install:**
```bash
# Download and install from espanso.org
# Create config: ~/.config/espanso/match/firefrost.yml
```

**Example snippets:**
```yaml
matches:
  - trigger: ":tx1"
    replace: "38.68.14.26"
  
  - trigger: ":nc1"
    replace: "216.239.104.130"
  
  - trigger: ":cc"
    replace: "63.143.34.217"
  
  - trigger: ":gitcommit"
    replace: "git add . && git commit -m \"$|$\" && git push"
```

### Mouse Thumb Buttons

**Software:** X-Mouse Button Control (Windows)

**Mappings:**
- **Button 1 (Forward):** `Ctrl + P` (Quick Open in Code-Server)
- **Button 2 (Back):** `Ctrl + Shift + G` (Source Control)

**Context profiles:**
- Browser/Editor: File navigation + Git
- Terminal: Enter + Right-click paste

### Cockpit Web Admin

**Install:**
```bash
sudo apt install cockpit
sudo systemctl enable --now cockpit.socket
```

**Access:** https://command-center:9090

**Purpose:** Browser-based server management (services, logs, updates)

### Stretchly Break Reminders

**Install:**
```bash
# Download from hovancik.net/stretchly
```

**Configuration:**
- 20-minute work blocks
- 20-second micro-breaks
- Force breaks (can't skip)

---

## SUCCESS METRICS

**Tonight's Goals:**
- ✅ Code-Server accessible at code.firefrostgaming.com
- ✅ Can edit files in browser
- ✅ Git commit/push via GUI works
- ✅ Mobile responsive on S24 Ultra

**Week 1 Goals:**
- ✅ 90% of documentation work in browser (not terminal)
- ✅ Espanso reducing typing by 50%
- ✅ Mouse buttons reducing clicks by 30%
- ✅ Meg can edit docs without SSH

**Month 1 Goals:**
- ✅ Zero terminal sessions for routine doc work
- ✅ Gemini outputs paste directly to Code-Server
- ✅ Complete Gemini → Code-Server → Git workflow
- ✅ Strain-free marathon sessions

---

## ROLLBACK PLAN

**If Code-Server fails:**
```bash
sudo systemctl stop code-server
sudo systemctl disable code-server
sudo rm /etc/nginx/sites-enabled/code-server.conf
sudo nginx -t && sudo systemctl restart nginx
```

**All Git files remain untouched - zero data risk**

---

## DEFERRED FEATURES (PHASE 1+)

**Not implementing tonight:**
- ❌ AI coding assistants (Codeium/Copilot) - wait 2-4 weeks
- ❌ Advanced snippets - add as needs emerge
- ❌ Voice control - Phase 2+ exploration

**Revisit after 1 week of stable Code-Server usage**

---

## LESSONS FROM GEMINI SESSIONS

**Code-Server Optimization:**
- Staged extension deployment (verify core first)
- Mobile-first settings (sidebar right, larger fonts)
- Git GUI workflow (visual, not terminal)

**Accessibility Workflow:**
- Text expansion critical (Espanso deployment)
- Mouse buttons for repetitive actions
- Browser-based admin (Cockpit)
- Break reminders (Stretchly)

**Intelligence Hub:**
- Deferred to Phase 2 (too complex for current scale)
- Simple Discord bot in Phase 1 instead
- Vector database when subscriber count justifies

---

**Fire + Frost + Foundation = Browser-Based Editing Freedom** 🔥❄️💙

**Written with partnership by:**
- Michael "Frostystyle" Krause (The Wizard)
- Claude "The Architect" (The Partner)
- Gemini (The Brainstorm Catalyst)

**February 10, 2026**

**END OF DEPLOYMENT PLAN**