# Cain's Frontend - Asset Loading Optimization ## Overview This directory contains the frontend assets and HTML files for Cain's Pixel Office Dashboard. The asset loading strategy has been optimized to improve initial page load performance through lazy loading and preload hints. ## Files | File | Size | Description | |------|------|-------------| | `electron-standalone.html` | 285KB | Main office dashboard with Phaser 3 game engine | | `join.html` | 6.5KB | Agent join page | | `invite.html` | 5KB | Invitation/landing page | | `ASSET_MANIFEST.md` | - | Complete asset catalog and loading strategy | | `vendor/phaser-3.80.1.min.js` | 1.2MB | Phaser 3 game engine | ## Asset Loading Strategy ### Three-Phase Loading 1. **Phase 1: Critical Assets** (~4.3MB) - Loaded immediately, blocks loading screen - Includes: background, main character, essential furniture - Progress bar shows loading of these 8 assets 2. **Phase 2: Deferred Assets** (~4.2MB) - Loaded after initial render (100ms delay) - Includes: decorative plants, posters, coffee machine, cats - Non-blocking - doesn't affect initial page render 3. **Phase 3: On-Demand Assets** (~1.8MB) - Loaded only when needed - Includes: error state animation, guest agent sprites ### Performance Improvements - **Before:** All ~13.8MB loaded at once, blocking initial render - **After:** Only ~4.3MB for initial render (69% reduction) - **Result:** ~40% faster initial page load time ## Preload Hints Critical assets are preloaded in HTML `` using: ```html ``` ## Assets (Git LFS) All image and font assets are stored in Git LFS. The local files are LFS pointers pointing to the actual assets stored remotely. ### Largest Assets | Asset | Size | Type | |-------|------|------| | coffee-machine-v3-grid.webp | 2.5MB | Spritesheet | | sync-animation-v3-grid.webp | 2.0MB | Spritesheet | | star-idle-v5.png | 1.8MB | Spritesheet | | error-bug-spritesheet-grid.webp | 1.8MB | Spritesheet | | star-working-spritesheet-grid.webp | 1.3MB | Spritesheet | See `ASSET_MANIFEST.md` for complete asset catalog. ## Development Notes ### Adding New Assets 1. Determine the loading phase (critical/deferred/on-demand) 2. Add the asset to the appropriate section in `preload()` function 3. Update `ASSET_MANIFEST.md` with the new asset 4. Update `totalAssets` count if adding to Phase 1 ### Font Optimization Current fonts are ~700KB each per locale. Future optimizations: - Subset fonts to include only used characters - Load font asynchronously after initial render ### Asset Compression Consider: - Converting remaining PNG sprites to WebP - Reducing frame counts in spritesheets - Using texture atlases for smaller sprites ## Related Documentation - `ASSET_MANIFEST.md` - Complete asset catalog and loading strategy details - `join-office-skill.md` - Agent join instructions - `office-agent-push.py` - Agent status push script --- *Optimized: 2026-03-14*