mirror of
https://github.com/duckietm/Nitro-V3.git
synced 2026-06-19 15:06:20 +00:00
medievalshell
8097344561
Runtime-loaded visual re-skin system (no client rebuild, real themes never hit git). A theme = a folder on the server (theme.base.url) with a manifest + CSS "pieces"; each piece is toggled from Settings > Themes (checkboxes). A broken/404 piece auto-falls back to the default (per piece). Hotel-wide default via ui-config theme.default (+ theme.default.pieces), per-user override in localStorage (same pattern as the catalog style toggle). - api/theme/ThemeManager: fetch index/manifest + inject/remove <link> + fallback - hooks/theme/useThemes: state + persist + default-from-config + live apply - components/theme/ThemeApplier: applies on boot (mounted in MainView) - UserSettings: General/Themes tabs with theme selector + per-piece checkboxes - custom-themes/: reference template (demo theme "Neon Viola" + README) - .gitignore: public/custom-themes/ (real themes are never committed)
Custom themes (graphics-only)
Ecosistema temi caricati a runtime (niente rebuild del client). Un tema = una cartella con un manifest + "pezzi" CSS. Ogni pezzo è attivabile/disattivabile dall'utente da Impostazioni → Temi (checkbox). Se un pezzo è rotto/404 → fallback automatico al default (solo quel pezzo).
Dove vivono
- Questa cartella (
custom-themes/) è solo il TEMPLATE di riferimento, versionata su git. - I temi veri stanno sul server in
public/nitro/custom-themes/(serviti via l'url configurato in ui-configtheme.base.url, es./client/nitro/custom-themes). NON vanno su git → vedi.gitignore(public/custom-themes/).
Struttura
custom-themes/
index.json # { "themes": [ { "id", "name", "author?" } ] }
<id>/
theme.json # { "name", "pieces": [ { "id", "name", "file" } ] }
cards.css chat.css ... # un file per "pezzo"
assets/... # immagini referenziate dai CSS (url assoluti)
Creare un tema
- Copia
neon-viola/in una nuova cartella<id>/. - Modifica
theme.json(nome + elenco pezzi). - Scrivi i CSS dei pezzi (override con
!important, caricati dopo il base). - Aggiungi
{ "id": "<id>", "name": "..." }aindex.json. - Carica la cartella in
public/nitro/custom-themes/sul server. Nessun rebuild.
Default hotel-wide (admin)
In ui-config.json:
theme.base.url→ dove sono serviti i temitheme.default→ id del tema attivo di default (vuoto = nessuno)theme.default.pieces→ array di id pezzi attivi di default
Ogni utente può comunque sovrascrivere da Impostazioni → Temi (salvato in localStorage).
Nota: i temi ri-skinnano solo la grafica (CSS). Non cambiano la struttura dei componenti né il comportamento.