wealth/docs/decisions/README.md

1.4 KiB

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.
  • 0011 Serve Yekan Bakh FaNum (font-sans, all UI text) and Yekan Bakh (font-latin, شبا and bank codes only) from public/fonts/ under fixed names declared in island fonts.css; no version, never hashed, never next/font; a changed font gets a new name.

Architecture (ADR)

  • 0001 Share one platform, platforms/market, between apps/bull and apps/bear; tag all three scope:market.
  • 0012 Wrap each app's next.config in island's withIconSprite and withFontCopy; they write symbol-defs.svg and the fonts into public/ unhashed, served immutable; link the sprite as ?v=<ICON_SPRITE_VERSION>.

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.