wealth/docs/decisions/README.md

15 lines
1.3 KiB
Markdown
Raw Normal View History

2026-10-04 18:03:42 +00:00
# Decisions
## Design (DDR)
- 0002 Render every tag through island `Element`, flex layouts through `FlexBox`, grid layouts through `GridBox`; never native JSX tags or `flex`/`grid` classes, island included.
- 0007 Serve Yekan Bakh FaNum (`font-sans`, all UI text) and Yekan Bakh (`font-latin`, شبا and bank codes only) as hashed `@font-face` files from the app's `public/fonts/` or our CDN, never `next/font`.
## Architecture (ADR)
- 0001 Share one platform, `platforms/market`, between `apps/bull` and `apps/bear`; tag all three `scope:market`.
- 0008 Register island's asset plugin in each app's `next.config`; on dev and build it writes hashed fonts and the svgo sprite into `public/`; the sprite stays same-origin.
## Proposed
- 0003 design: Only semantic tokens, named as in the Lumina Design System, produce Tailwind utilities (`@theme inline`); primitives stay plain `:root` variables and Tailwind's defaults are removed.
- 0005 design: Island holds Lumina's product components and status-to-tone map; they take every text as props (`children` or `labels`) and never import i18next or platform code.
- 0006 architecture: Make every non-app project a pnpm workspace package `@lumina/<name>` with subpath `exports`; third-party dependencies stay in the root package.json.