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

{
  "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

[
  {
    "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

{
  "window.zoomLevel": 0.5,
  "workbench.sideBar.location": "right",
  "explorer.compactFolders": false,
  "breadcrumbs.enabled": true,
  "editor.tabSize": 2
}

Chromebook

{
  "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

"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

"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

"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

curl -fsSL https://code-server.dev/install.sh | sh

2. Configure

mkdir -p ~/.config/code-server
nano ~/.config/code-server/config.yaml

bind-addr: 127.0.0.1:8080
auth: password
password: [SECURE_PASSWORD]
cert: false

3. Create systemd Service

sudo nano /etc/systemd/system/code-server.service

[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

sudo systemctl daemon-reload
sudo systemctl enable code-server
sudo systemctl start code-server
sudo systemctl status code-server

5. Nginx Reverse Proxy

sudo nano /etc/nginx/sites-available/code-server.conf

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;
    }
}

sudo ln -s /etc/nginx/sites-available/code-server.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

6. SSL Certificate

sudo certbot --nginx -d code.firefrostgaming.com

7. Firewall

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload

8. Verify

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:

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

Example snippets:

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:

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:

# 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:

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