wealth/docs/decisions
Amiram_se 0d2528d66f docs(decisions): propose 0014, registration step 5 on the session
Step 5 runs under (onboarding) behind AuthGuard; a creator's profile
autosaves as a server draft and completes only through
POST /traders/me/profile/complete.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 22:33:00 +04:00
..
0001-one-platform-shared-by-mobile-and-desktop.md chore: docs 2026-10-04 22:03:42 +04:00
0002-island-layout-and-element-over-native-tags.md chore: docs 2026-10-04 22:03:42 +04:00
0003-semantic-tokens-only-in-theme.md chore: docs 2026-10-04 22:03:42 +04:00
0004-self-hosted-yekan-bakh.md chore: docs 2026-10-04 22:03:42 +04:00
0005-island-components-take-text-as-props.md chore: docs 2026-10-04 22:03:42 +04:00
0006-pnpm-workspaces-and-package-exports.md chore: docs 2026-10-04 22:03:42 +04:00
0007-yekan-bakh-from-public-or-cdn.md docs(decisions): fixed-name fonts and sprite versioned in its link 2026-10-05 19:00:46 +04:00
0008-island-asset-plugin.md docs(decisions): fixed-name fonts and sprite versioned in its link 2026-10-05 19:00:46 +04:00
0009-versioned-yekan-bakh-never-hashed.md docs(decisions): fixed-name fonts and sprite versioned in its link 2026-10-05 19:00:46 +04:00
0010-island-sprite-and-font-plugins.md docs(decisions): fixed-name fonts and sprite versioned in its link 2026-10-05 19:00:46 +04:00
0011-yekan-bakh-under-fixed-names.md docs(decisions): fixed-name fonts and sprite versioned in its link 2026-10-05 19:00:46 +04:00
0012-sprite-version-in-link.md docs(decisions): fixed-name fonts and sprite versioned in its link 2026-10-05 19:00:46 +04:00
0013-auth-pages-render-in-the-browser.md docs(decisions): auth pages render in the browser 2026-10-05 20:06:42 +04:00
0014-registration-step-5-on-the-session.md docs(decisions): propose 0014, registration step 5 on the session 2026-10-05 22:33:00 +04:00
README.md docs(decisions): propose 0014, registration step 5 on the session 2026-10-05 22:33:00 +04:00

README.md

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>.
  • 0013 Render every (auth) page's steps only in the browser behind GuestGuard: the server sends the frame, a same-size skeleton and noindex; flow state stays in memory, never in the URL or storage.

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.
  • 0014 architecture: Serve registration step 5 under (onboarding) behind AuthGuard; a creator's profile autosaves as a server draft (PATCH) and completes only through POST …/profile/complete.