Theme System

Documentation for the GoGrab Space theme system: CSS variables, runtime services, SCSS utilities, and design patterns.

🎯 Start Here

📚 Core Guides

Setup & Integration

• Setup Guide — Integration instructions
• Theme Setup — APP_INITIALIZER, persistence, timing
• Theme System Usage — Services, CSS vars, anti-patterns

Architecture & Reference

• Architecture — System design and data flow
• System Summary — High-level overview
• CSS Variables — Complete variable reference
• API Reference — Service and interface documentation

Libraries

• @theme-runtime — Runtime services and orchestration
• @theme-styles — SCSS tokens, utilities, effects
• @theme-dev-tools — Debuggers, editors, demos

🎨 Design & Patterns

• Modularity Style Guide — Dark dashboard vibe, glassmorphism, gradients
• Design Prompts — Design patterns for AI
• Admin Panel Design System — Admin-specific patterns

💾 Storage & Persistence

• Storage Integration — Persistence and sync
• Flash Persistence Integration — Flash persistence
• Theme Persistence (MongoDB) — MongoDB backend
• Space-Specific Persistence — Per-space themes

🛠️ Development & Best Practices

• Best Practices — Expert guidelines
• Performance — Optimization tips
• Migration Guide — Upgrade path
• Theme Switcher — Switching themes
• Theme Editor Demo — End-to-end editing flow

🧪 Testing & Fixes

• Test Theme Persistence — Persistence tests
• Testing Guide (Persistence) — Persistence testing guide
• Theme Library Fix — Library fixes
• Theme Library API Base URL Fix — API URL fixes
• Theme Library Design Improvements — Design improvements
• Cross-Browser Compatibility Fixes — Browser fixes
• Infinite Loop Fixes — Loop fixes
• Latest Storage Updates — Storage updates

📋 Planning

• Plan Index — Planning overview
• Plan — Theme system plan
• Progress — Implementation progress
• Reorganization Execution Plan — Reorganization plan

📍 Library Paths