mirror of
https://codeberg.org/PostERG/xamxam.git
synced 2026-09-25 01:53:03 +02:00
1.7 KiB
1.7 KiB
CSS Architecture
Source files (app/public/assets/css/)
variables.css— all CSS custom properties (colors, spacing, sizing tokens)colors.css— colour tokens (referenced byvariables.css)reset.css/modern-normalize.min.css— resetsbase.css— base element stylescommon.css— shared components (header/nav, search bar, accessibility, buttons)typography.css— type scaleutilities.css— utility classes and spacing tokensstyle.css— main public entry point (via@importchain)- Page-specific:
public.css(home),tfe.css,repertoire.css,content-page.css(about/licences),system.css(admin system dashboard),file-access.css,admin.css(admin section) - Form:
form-base.css+form-admin.css(plus FilePond vendor CSS)
Build / bundling
Source CSS is bundled and minified by scripts/build-css.mjs (lightningcss)
into app/public/assets/dist/*.min.css:
base.min.css— resolves the@importchain instyle.cssinto one file (eliminates ~17 sequential imports)admin.min.css— minifiedadmin.cssform.min.css—form-base.css+form-admin.css+ FilePond vendor CSS- plus individual
.min.cssfor the page-specific files
Run with just build-css / just dev-build. Never commit hand-edits into
dist/ — they are generated.
Rules
- Colour values live in
variables.css/colors.cssas custom properties; avoid hardcoding hex/rgb in other files. - Admin and public share the same token names — no separate admin theme.
modern-normalize.min.cssand FilePond vendor CSS are third-party (minified — do not edit).