Add vapor shell preset selection flow for host apps

2026-02-28 18:55:43 +03:00
parent 0e710ec4ce
commit 7ee984a225
9 changed files with 153 additions and 7 deletions
@@ -14,6 +14,17 @@ Optional: host project can override shell height without changing preset IDs:
 :root { --shell-height: 72px; }
 ```

+## Selection Approach
+
+Recommended precedence for host integration:
+
+1. `?vapor_shell=<preset-id>` query parameter (preview/share links)
+2. `localStorage["vapor_shell"]` (remembered user choice)
+3. `<html data-vapor-shell="...">` static default from server/templates
+4. fallback preset: `miami-sunset`
+
+The scaffold and demo JavaScript implement this precedence.
+
 ## Presets (Header + Accent)

 | Preset ID | Header core | Accent core | Default shell height |