wealth/docs/decisions
Amiram_se 9ea17684ad docs(decisions): record 0015–0019
0015 own route for a view with its own frame, 0016 needsProfile and OnboardingGuard, 0017 a loading skeleton per step (proposed); 0018 the /api rewrite and 0019 toasts close by themselves (accepted).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 21:47:26 +04:00
..
0001-one-platform-shared-by-mobile-and-desktop.md
…
0002-island-layout-and-element-over-native-tags.md
…
0003-semantic-tokens-only-in-theme.md
…
0004-self-hosted-yekan-bakh.md
…
0005-island-components-take-text-as-props.md
…
0006-pnpm-workspaces-and-package-exports.md
…
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
0015-a-view-with-its-own-frame-gets-its-own-route.md docs(decisions): record 0015–0019 2026-10-06 21:47:26 +04:00
0016-unfinished-creators-stay-on-step-5.md docs(decisions): record 0015–0019 2026-10-06 21:47:26 +04:00
0017-each-step-owns-its-loading-skeleton.md docs(decisions): record 0015–0019 2026-10-06 21:47:26 +04:00
0018-browser-calls-the-api-through-a-next-rewrite.md docs(decisions): record 0015–0019 2026-10-06 21:47:26 +04:00
0019-every-toast-closes-by-itself.md docs(decisions): record 0015–0019 2026-10-06 21:47:26 +04:00
README.md docs(decisions): record 0015–0019 2026-10-06 21:47:26 +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.
  • 0019 Close every toast by itself: success and info after 4 s (6 with an action), errors after 8 s (10 with an action); hovering or a hidden tab pauses it; never duration: Infinity.

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.
  • 0018 Call the API from the browser only on the app's own origin under /api, rewritten by next.config.ts to API_INTERNAL_ORIGIN; media URLs use the same path, and the server render calls the gateway directly.

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.
  • 0015 architecture: Serve a login or onboarding view whose frame differs from its step on its own route (/auth/login/suspended, /onboarding/creator-profile/done); browser-only data stays in memory.
  • 0016 architecture: Keep a creator who hasn't finished step 5 out of publishing and pricing through the session's needsProfile, with OnboardingGuard in those routes' layouts and GuestGuard.
  • 0017 architecture: Give every auth and onboarding route its own loading.tsx matching its frame; an index route with nested steps sits in its own route group.