Monaco Electric Construction Services - Canonical Source

THE SOURCE OF TRUTH for monacoelectric.com production website.

Color Scheme

Color	Value	Usage
Navy Blue	#0B1E3F	Primary background, headers
Gold/Orange	#F6B12D	Accent, CTAs, highlights
White	#FFFFFF	Text on dark backgrounds

Architecture

monacoelectric.com
├── Base Image: ghcr.io/pooknast/hungry-hippo (GitHub Actions)
└── Customizations: Applied via reapply-customizations.sh

Directory Structure

.
├── app/                        # FastAPI application (from container)
│   ├── main.py                 # Main FastAPI app with custom routes
│   ├── core/config.py          # Configuration settings
│   ├── templates/              # Jinja2 templates
│   └── static/                 # Static assets (CSS, JS, images)
│
├── customizations/             # VPS overlay files
│   ├── reapply-customizations.sh  # CRITICAL: Script to restore site
│   ├── base.html               # Custom base template (navy/gold)
│   ├── index.html              # Custom homepage
│   ├── *.html                  # Custom page templates
│   ├── partials/               # HTMX partials
│   ├── static/                 # Custom static files
│   └── COLOR_REFERENCE.md      # Design documentation
│
└── requirements.txt            # Python dependencies

Deployment

Production VPS (monaco-ts)

The site runs on monaco-ts VPS via Traefik reverse proxy.

Location: /home/monaco1/traefik/hungry-hippo-customizations/

Restore/Deploy Procedure

# 1. Connect to VPS
python3 /path/to/vps_session_manager.py connect monaco-ts

# 2. Sync customizations to VPS
scp -r customizations/* monaco-ts:/home/monaco1/traefik/hungry-hippo-customizations/

# 3. Apply customizations
ssh monaco-ts "/home/monaco1/traefik/hungry-hippo-customizations/reapply-customizations.sh"

Container Image

• Registry: ghcr.io/pooknast/hungry-hippo:latest
• Built by: GitHub Actions on push to main
• Revision: e36bc866384e40e9399c418999b904c16d15677f

Tech Stack

• Backend: FastAPI (Python 3.11)
• Frontend: HTMX + Alpine.js
• CSS: Tailwind CSS with oklch() colors
• Reverse Proxy: Traefik with Let's Encrypt TLS

Important Files

File	Purpose
customizations/reapply-customizations.sh	Restores site after container restart
customizations/COLOR_REFERENCE.md	Design system documentation
app/main.py	FastAPI routes with CacheControlMiddleware
app/templates/base.html	Base template with navy/gold theme

DO NOT

• Push changes to GitHub hungry-hippo repo without testing
• Modify container image without updating customizations
• Delete the customizations directory on VPS
• Use the "Emergency Modernism" red theme (that's a different project)

---

Last Updated: 2026-01-30 Canonical Repo: forgejo:pook/monaco-electric