JustPark's cross-platform design system — web, iOS, Android.
Warning
2026 rebrand — work in progress. DESIGN.md now carries the Phase 2
rebrand tokens (Forest/Ink/electric-green palette, real-alpha overlays,
modal light/dark semantic layer, Rubik). The generated outputs
(design-tokens/tokens.json, dist/*) have not been regenerated and
still reflect the pre-rebrand system — do not consume them for new work
until the export pipeline gains mode/alpha support (see Migration notes in
DESIGN.md). Park Sans display font files are pending; display-brand
renders as Rubik for now. Source Figma: JustPark Rebrand – Product
Exploration.
| File | Purpose |
|---|---|
DESIGN.md |
Source of truth. Token values (YAML front matter) + brand rationale (prose). |
platforms/ios/DESIGN.md |
iOS implementation guidance — native-first, adapter pattern. |
platforms/android/DESIGN.md |
Android implementation guidance — Material 3 + LotusTheme. |
platforms/web/DESIGN.md |
Web implementation guidance — @justpark/ui + SCSS token layer. |
design-tokens/tokens.json |
Generated from DESIGN.md front matter. Do not edit directly. |
Point your AI tooling (Claude, Cursor) at two files:
- Root
DESIGN.md— what the tokens are and why - Your platform's
platforms/*/DESIGN.md— how to use them
Token values live in the YAML front matter of DESIGN.md. Use lotus-dsm to make changes — it validates, diffs, and opens a PR. Do not hand-edit the front matter or tokens.json.
Every pull request lints DESIGN.md with @google/design.md lint — schema validation, broken token references, and WCAG contrast checks.