Apply the Grimoirix colour palette and design system to the web front end #148

Closed
opened 2026-11-12 21:57:48 +00:00 by vivy · 5 comments
Owner

Board: GRI-1941

Goal

Restyle the web front end (frontend-web/) to the Grimoirix colour palette and design system.

Source of truth

  • frontend-web/design/grimoirix-color-scheme.md — the only list of token names and values.
  • frontend-web/design/grimoirix-design-system.md — typography, components, spacing, motion.
  • frontend-web/design/grimoirix-example.html — a visual reference to open in a browser.
  • Template repo: Grimoirix/grimoirix-frontend-template.

These land with PR #147. Start after it is merged into dev.

Scope

  1. Put the tokens from the colour scheme into the app's global CSS (:root = dark, :root[data-theme="light"] = light).
  2. Replace hard-coded colours in components with the tokens.
  3. Fonts: Cinzel for headings, Spline Sans for body. Loading them from Google Fonts or from design/fonts/ are both fine; keep the source one setting, not spread over components.
  4. Dark mode is the default; add a dark/light toggle that remembers the choice.
  5. No pure white (#FFFFFF) anywhere.

Not in scope

Layout or feature changes. The design is the product owner's preferred design and a reference: a project may differ where it has a reason — write the reason in the PR.

Done when

  • No colour literal left in components outside the token file (grep -rE '#[0-9a-fA-F]{3,8}\b' shows only the token file).
  • Both themes checked: text meets WCAG AA, focus ring visible, prefers-reduced-motion respected.
  • frontend-web CI gate is green.
Board: GRI-1941 ## Goal Restyle the web front end (`frontend-web/`) to the Grimoirix colour palette and design system. ## Source of truth - `frontend-web/design/grimoirix-color-scheme.md` — the only list of token names and values. - `frontend-web/design/grimoirix-design-system.md` — typography, components, spacing, motion. - `frontend-web/design/grimoirix-example.html` — a visual reference to open in a browser. - Template repo: `Grimoirix/grimoirix-frontend-template`. These land with PR #147. Start after it is merged into `dev`. ## Scope 1. Put the tokens from the colour scheme into the app's global CSS (`:root` = dark, `:root[data-theme="light"]` = light). 2. Replace hard-coded colours in components with the tokens. 3. Fonts: Cinzel for headings, Spline Sans for body. Loading them from Google Fonts or from `design/fonts/` are both fine; keep the source one setting, not spread over components. 4. Dark mode is the default; add a dark/light toggle that remembers the choice. 5. No pure white (`#FFFFFF`) anywhere. ## Not in scope Layout or feature changes. The design is the product owner's preferred design and a reference: a project may differ where it has a reason — write the reason in the PR. ## Done when - No colour literal left in components outside the token file (`grep -rE '#[0-9a-fA-F]{3,8}\b'` shows only the token file). - Both themes checked: text meets WCAG AA, focus ring visible, `prefers-reduced-motion` respected. - `frontend-web` CI gate is green.
Author
Owner

The design files now also hold the code (template v0.1.0). When you restyle, use it instead of writing your own:

  • styles: frontend-web/design/css/grimoirix.css (or @use design/scss/grimoirix if you add Sass). Tokens are var(--…); components are gx-btn, gx-card, gx-tag, gx-note, gx-input, gx-theme-toggle.
  • theme switch: initTheme() in main.tsx before render, and useTheme() from design/ts/react.ts for the toggle button.
  • do not edit design/ here; change the template and copy it again.
The design files now also hold the code (template v0.1.0). When you restyle, use it instead of writing your own: - styles: `frontend-web/design/css/grimoirix.css` (or `@use` `design/scss/grimoirix` if you add Sass). Tokens are `var(--…)`; components are `gx-btn`, `gx-card`, `gx-tag`, `gx-note`, `gx-input`, `gx-theme-toggle`. - theme switch: `initTheme()` in `main.tsx` before render, and `useTheme()` from `design/ts/react.ts` for the toggle button. - do not edit `design/` here; change the template and copy it again.
Member

Opened PR #149 against dev: applies the Grimoirix design system to frontend-web (tokens/fonts/gx- components from the template, dark/light toggle, all screens restyled). npm run check, npm run build, and scripts/local-gates.sh --frontend-only all pass locally; drove the dev server headless to confirm both themes, fonts, focus ring and no pure white. Waiting on forge CI.

Opened PR #149 against dev: applies the Grimoirix design system to frontend-web (tokens/fonts/gx- components from the template, dark/light toggle, all screens restyled). `npm run check`, `npm run build`, and `scripts/local-gates.sh --frontend-only` all pass locally; drove the dev server headless to confirm both themes, fonts, focus ring and no pure white. Waiting on forge CI.
Member

CI on PR #149 (commit 1298da52) is green: CI / CI (pull_request) — the aggregate required check — passed, and fj ci reports exit 0 ("CI passed").

Per-job detail:

  • cargo clippy, cargo fmt, cargo test, frontend-web, repository boundary, pre-push hook — all successful.
  • cargo deny advisories failed, but this is pre-existing and unrelated to this change: it flags glib/paste/proc-macro-error advisories from the Tauri/GTK native-client dependency tree, nothing in frontend-web. Not introduced by this PR.

Ready for review/merge. Handing to the CTO.

CI on PR #149 (commit `1298da52`) is green: `CI / CI (pull_request)` — the aggregate required check — passed, and `fj ci` reports exit 0 ("CI passed"). Per-job detail: - cargo clippy, cargo fmt, cargo test, frontend-web, repository boundary, pre-push hook — all successful. - `cargo deny advisories` failed, but this is pre-existing and unrelated to this change: it flags `glib`/`paste`/`proc-macro-error` advisories from the Tauri/GTK native-client dependency tree, nothing in `frontend-web`. Not introduced by this PR. Ready for review/merge. Handing to the CTO.
Author
Owner

Merged PR #149 into dev (head 1298da52, verified an ancestor of dev). All 6 required contexts green; cargo deny advisories is red but not required. The branch is deleted with the merge; cut a new branch off origin/dev for any further work.

Merged PR #149 into `dev` (head `1298da52`, verified an ancestor of `dev`). All 6 required contexts green; `cargo deny advisories` is red but not required. The branch is deleted with the merge; cut a new branch off `origin/dev` for any further work.
Author
Owner

Landed in dev by PR #149 (merged 2026-11-12 23:40 UTC, dev 20518cd). Closing.

Landed in dev by PR #149 (merged 2026-11-12 23:40 UTC, dev 20518cd). Closing.
vivy closed this issue 2026-11-13 00:29:42 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Grimoirix/grimoire-of-digital-signage#148
No description provided.