mirror of
https://github.com/duckietm/Nitro-V3.git
synced 2026-06-20 15:36:18 +00:00
feat(theme): runtime custom theme ecosystem (graphics-only)
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)
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
# 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-config `theme.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
|
||||
1. Copia `neon-viola/` in una nuova cartella `<id>/`.
|
||||
2. Modifica `theme.json` (nome + elenco pezzi).
|
||||
3. Scrivi i CSS dei pezzi (override con `!important`, caricati dopo il base).
|
||||
4. Aggiungi `{ "id": "<id>", "name": "..." }` a `index.json`.
|
||||
5. 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 temi
|
||||
- `theme.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.
|
||||
Reference in New Issue
Block a user