firefrost-gaming/firefrost-operations-manual

Fork 0

Files

mkrause612 6e1e63461c Reorg: Move sandbox session to docs/sandbox/sessions/

2026-02-12 01:00:47 -06:00

6.0 KiB

Raw Blame History

Gemini Session: Code-Server Deployment Optimization

Date: February 10, 2026

Participants: Michael "Frostystyle" Krause & Gemini

Status: Ready for Production Implementation

1. Session Overview

We designed a specialized workspace configuration for the deployment of code.firefrostgaming.com. The goal was to transform Code-Server into a high-efficiency documentation hub that minimizes repetitive typing, eliminates the need for the SSH terminal for Git operations, and remains fully functional on both a Chromebook and a Samsung S24 Ultra, specifically accounting for permanent hand nerve damage.

2. VS Code Extensions Recommendations

Essential Extensions

Markdown All in One: Automates formatting (lists, bold, links) and generates Tables of Contents to reduce manual typing.
GitLens: Provides inline "blame" annotations and hover-over history, allowing for file review without terminal commands.
Git Graph: Essential for a visual-first workflow. It allows for complex Git operations (merging, pulling, branching) via a right-click graphical interface.

Mobile-Optimized Extensions

vscode-icons: Adds high-contrast, distinct icons to the file explorer, making navigation significantly easier on the smaller S24 Ultra screen.
Error Lens: Highlights errors directly on the line of code or markdown text, removing the need to open and click through a separate "Problems" panel.

Accessibility Extensions

Markdown Lint: Automatically catches formatting issues in documentation, reducing the need for manual review and re-typing.
Prettier: Set to "Format on Save" to ensure all documentation remains consistent without manual spacing or indentation effort.

3. Workspace Configuration

settings.json

{
  "files.autoSave": "onFocusChange",
  "editor.fontSize": 16,
  "editor.wordWrap": "on",
  "editor.minimap.enabled": false,
  "workbench.editor.restoreViewState": true,
  "explorer.confirmDelete": false,
  "explorer.confirmDragAndDrop": false,
  "git.confirmSync": false,
  "git.autofetch": true,
  "editor.formatOnSave": true
}

Auto-save (onFocusChange): Automatically saves files when you switch tabs or click away, eliminating Ctrl+S.
No Minimap: Reclaims screen width for better mobile readability.
Disabled Confirmations: Removes "Are you sure?" prompts to reduce unnecessary clicks.

Keybindings

Ctrl + \: Toggle Sidebar (Instantly hide the file explorer for a distraction-free writing space).
Alt + Z: Toggle Word Wrap (Critical for viewing wide logs or long paragraphs on the S24 Ultra).

4. Mobile Optimization Strategy

Chromebook Configuration

UI Scaling: Set window.zoomLevel to 1 to increase the size of icons and sidebar text for easier targeting with the trackpad or touch.
Touch Mode: Ensure "Touch UI" is enabled in settings to increase the padding between menu items.

Samsung S24 Ultra Configuration

Sidebar Placement: Move the Sidebar to the Right (workbench.sideBar.location: "right"). This allows your thumb to navigate the file tree more naturally while holding the phone.
Compact Folders: Set explorer.compactFolders: false to make the file structure easier to read on a narrow screen.

PWA Setup

Open Chrome on the device and navigate to code.firefrostgaming.com.
Tap the three-dot menu and select "Install App" or "Add to Home Screen."
This launches Code-Server in its own window, removing browser tabs and providing 15% more vertical screen real estate.

5. Git Workflow Design

Visual Commit Process

Open the Source Control tab (Ctrl+Shift+G).
Click the + (Plus) icon next to "Changes" to stage all files.
Type a short keyword and use a Snippet to populate the full commit message.
Click the Checkmark icon at the top to commit.

Branch Management

Open the Git Graph view from the status bar.
Right-click any branch to checkout, merge, or rebase.
Use the Sync Changes (circular arrow) icon in the bottom-left corner to perform a push/pull in one click.

6. Snippet Library

Git Commit Messages

Prefix: gcm
Template: Docs: Updated ${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE} - [Summary of changes]

Markdown Templates

Prefix: ffheader
Template: A standardized header with Date, Author (Frostystyle), and Status (Draft/Final).

Documentation Headers

Prefix: fflog
Template: Includes the Firefrost logo, versioning table, and horizontal rules for clean session logging.

7. Mouse Thumb Button Mappings

Recommended Mappings

Button 1 (Top/Forward): Map to Ctrl + P (Quick Open). Instantly search and jump to any of the 28+ files in your repo without browsing folders.
Button 2 (Bottom/Back): Map to Ctrl + Shift + G (Source Control). Instantly brings up the Git menu for staging and committing.

Software Recommendations

Logi Options+: If using a Logitech vertical mouse.
X-Mouse Button Control: For Windows-based environments.
Solaar: For Linux-based desktop environments.

Context-Specific Profiles

Editor View: Use Button 1 for file jumping.
Documentation Review: Re-map Button 2 to Alt + Z if you find yourself frequently toggling word wrap for long logs.

8. Implementation Checklist

Install recommended extensions (Markdown All in One, Git Graph, GitLens)
Apply settings.json configuration
Configure keybindings for Sidebar and Word Wrap
Set up PWA on Chromebook and S24 Ultra
Program mouse thumb buttons via software
Create snippet library for Git and Markdown
Test mobile access and visual Git commit flow

9. Claude Review Notes

[Space for Claude's production assessment]

Output File: gemini-code-server-optimization-2026-02-10.md

Next Step: Deploy Code-Server tonight with these optimizations

Fire + Frost = Where Passion Meets Precision 🔥❄️

6.0 KiB Raw Blame History