update 2026-10-25 16:53:21

luci-theme-footstrap/README.md

@@ -11,9 +11,7 @@ Internal name: `footstrap`. Media path: `/luci-static/footstrap`.
 by default, or the side menu), mode, palette, density, wallpaper, rounding and every colour — accent,
 the three status colours, the four surfaces — are **client** axes on the System → Footstrap page:
 `localStorage` plus attributes and inline properties on `:root`, and nothing is written to the
-router until "Save as default" is pressed. There are no per-layout or per-mode themes; every legacy
-name (`FootstrapSidebar`, `FootstrapOnTop`, `…-dark`/`…-light`) is deleted by
-`root/etc/uci-defaults/30_luci-theme-footstrap`.
+router until "Save as default" is pressed. There are no per-layout or per-mode themes.
 
 There is one menu renderer too, `renderMainMenu` in `fs-chrome.js`. The top bar is its own markup, morphed by CSS
 through `:root[data-layout]`. No second template, no second renderer, no `footstrap-top` symlink.
@@ -26,11 +24,11 @@ and only re-arranges the stock overview sections.
 
 ```
 Makefile                          luci.mk; LUCI_MINIFY_CSS:=0; Build/Prepare (CSS, mangle, strip,
-                                  version, po2lmo)
+                                  version)
 styles/                           CSS SOURCE: layers tokens / base / theme / pages
 build-css.sh                      styles/ → htdocs/luci-static/footstrap/cascade.css
 mangle-tokens.sh                  shorten the private --fs-* names in a built sheet, then join it to one line
-strip-build.sh                    build-tree strip, one mode each: templates, shell, probes, assets
+strip-build.sh                    build-tree strip, one mode each: templates, shell, assets
 po/                               translation catalogue (Weblate translates this)
 ucode/template/themes/footstrap/  header.ut, footer.ut, sysauth.ut, partials/
 htdocs/luci-static/footstrap/     cascade.css (generated), logo.svg — no webfonts, and no
@@ -38,14 +36,14 @@ htdocs/luci-static/footstrap/     cascade.css (generated), logo.svg — no webfo
                                   is one the admin installs (repo: fonts/set-font.sh)
 htdocs/luci-static/resources/     menu-footstrap.js (footer entry), menu-footstrap-common.js,
                                   fs-{fit,menutree,prefs,widgets,chrome,router,sheets,search,
-                                  select,appearance,version,overview}.js
-root/etc/uci-defaults/            registration and legacy-name migration
-root/usr/share/rpcd/acl.d/        ACL: uci footstrap (Save as default) + login-background upload
+                                  select,appearance,assets,axes,version,overview}.js
+root/etc/uci-defaults/            registration and the upload symlinks
+root/usr/share/rpcd/acl.d/        ACL: uci footstrap (Save as default) + login-background and pattern uploads
 ```
 
 There is no update checker: the theme is installed from the package feed (`install.sh` adds it), so
-`apk upgrade` / `opkg upgrade` carries it forward like everything else on the router. The Footstrap
-tab shows the version it is running and makes no network call to do it.
+`apk upgrade` / `opkg upgrade` carries it forward like everything else on the router. The System → Footstrap
+page shows the version it is running and makes no network call to do it.
 
 **Do not edit `cascade.css`** — it is generated by `build-css.sh` from `styles/` and is gitignored.
 Colours go in `styles/03-palettes.css`, scales and tokens in `styles/02-tokens.css`.
@@ -62,6 +60,6 @@ ssh router 'uci set luci.main.mediaurlbase=/luci-static/footstrap; uci commit lu
 ssh router 'uci set luci.main.mediaurlbase=/luci-static/bootstrap; uci commit luci'   # roll back
 ```
 
-Before pushing, run `npm run check` from the repository root. The rules and the traps are in
+Before pushing, see [`../docs/verifying.md`](../docs/verifying.md). The rules and the traps are in
 [`../docs/conventions.md`](../docs/conventions.md); packaging is in
 [`../docs/package.md`](../docs/package.md).