zeroclaw/site/README.md
argenis de la rosa b3887d7ddf feat(site): add es/pt/it locale support with UI selector
- Expand runtime locale support from 2 to 5 locales (en, zh, es, pt, it)
- Add locale normalization/cycling logic and button labels
- Add Spanish/Portuguese/Italian UI text bundles
- Update localized labels for journey/audience/kind, reading paths,
  command-lane hints, and engineering pillars
- Rework locale rendering with fallback helper for untranslated fields
- Update language toggle behavior in command palette
- Add localized README files (es, pt, it)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 04:50:31 -05:00

2.2 KiB

ZeroClaw GitHub Pages Frontend (Vite)

This is the standalone frontend for GitHub Pages.

Languages: English | Español | Português | Italiano

Commands

cd site
npm install
npm run dev

Build for GitHub Pages:

cd site
npm run build

Build output is generated at:

/home/ubuntu/zeroclaw/gh-pages

Notes:

  • Output directory is intentionally gh-pages/ (not out/).
  • Vite base is configured to /zeroclaw/ for https://zeroclaw-labs.github.io/zeroclaw/.
  • Docs links in UI point to rendered GitHub docs pages for direct reading.
  • Docs Navigator supports:
    • keyword search with weighted ranking
    • category and level filters (Core / Advanced)
    • quick keyboard shortcuts: / to focus search, Esc to reset filters
  • "Quick Start Paths" provides task-first doc flows for onboarding, channels, and hardening.
  • Command palette is enabled:
    • open via Ctrl/Cmd + K
    • includes quick actions (jump docs, repo, theme/language switching)
    • includes direct docs fuzzy search entries
    • supports keyboard navigation ( / / Enter) with active-item highlighting
    • supports Tab / Shift+Tab cycling and live preview panel (desktop)
  • Theme system is enabled:
    • Auto / Dark / Light
    • preference persisted in localStorage
  • i18n is enabled:
    • UI currently supports English and 简体中文
    • Additional README translations are available in Español, Português, and Italiano
    • language preference persisted in localStorage
    • URL language parameter (?lang=en / ?lang=zh) is synchronized for shareable links
  • Responsive system is deepened:
    • improved breakpoints for desktop/tablet/mobile
    • adaptive topbar controls and panel layouts
    • container query used for doc-card compact mode
    • desktop section rail + mobile quick dock for faster long-page navigation

Deployment

The repository includes workflow:

.github/workflows/pages-deploy.yml

Behavior:

  • Trigger on pushes to main when site/**, docs/**, or README.md changes.
  • Build runs in site/ and publishes artifact from gh-pages/.
  • Deploys with GitHub Pages official actions.