From 9de000f3d21d7bc1f721388280784f7ace96825f Mon Sep 17 00:00:00 2001 From: Amiram_se Date: Sun, 4 Oct 2026 22:03:42 +0400 Subject: [PATCH] chore: docs --- ...e-platform-shared-by-mobile-and-desktop.md | 17 + ...and-layout-and-element-over-native-tags.md | 22 + .../0003-semantic-tokens-only-in-theme.md | 21 + docs/decisions/0004-self-hosted-yekan-bakh.md | 20 + ...05-island-components-take-text-as-props.md | 22 + ...006-pnpm-workspaces-and-package-exports.md | 17 + .../0007-yekan-bakh-from-public-or-cdn.md | 22 + docs/decisions/0008-island-asset-plugin.md | 27 + docs/decisions/README.md | 14 + docs/design-brief.md | 426 -------- docs/round-1-channel-and-posts.md | 944 ------------------ docs/round-2-auth-and-onboarding.md | 680 ------------- docs/round-3-investor-subscriptions.md | 902 ----------------- docs/round-4-creator-money.md | 543 ---------- docs/round-5-admin.md | 347 ------- 15 files changed, 182 insertions(+), 3842 deletions(-) create mode 100644 docs/decisions/0001-one-platform-shared-by-mobile-and-desktop.md create mode 100644 docs/decisions/0002-island-layout-and-element-over-native-tags.md create mode 100644 docs/decisions/0003-semantic-tokens-only-in-theme.md create mode 100644 docs/decisions/0004-self-hosted-yekan-bakh.md create mode 100644 docs/decisions/0005-island-components-take-text-as-props.md create mode 100644 docs/decisions/0006-pnpm-workspaces-and-package-exports.md create mode 100644 docs/decisions/0007-yekan-bakh-from-public-or-cdn.md create mode 100644 docs/decisions/0008-island-asset-plugin.md create mode 100644 docs/decisions/README.md delete mode 100644 docs/design-brief.md delete mode 100644 docs/round-1-channel-and-posts.md delete mode 100644 docs/round-2-auth-and-onboarding.md delete mode 100644 docs/round-3-investor-subscriptions.md delete mode 100644 docs/round-4-creator-money.md delete mode 100644 docs/round-5-admin.md diff --git a/docs/decisions/0001-one-platform-shared-by-mobile-and-desktop.md b/docs/decisions/0001-one-platform-shared-by-mobile-and-desktop.md new file mode 100644 index 0000000..e38ec26 --- /dev/null +++ b/docs/decisions/0001-one-platform-shared-by-mobile-and-desktop.md @@ -0,0 +1,17 @@ +# 0001 One platform shared by mobile and desktop apps + +Status: Accepted · Area: architecture · Date: 2026-10-04 · Decided by: user + +## Context +The product ships two Next.js apps, `bull` (mobile) and `bear` (desktop), that serve the same Lumina product. Both apps serve under one domain; nginx proxies each request to the mobile or desktop app based on its user agent. The default rule gives each app its own platform. + +## Decision +Both `apps/bull` and `apps/bear` depend on one platform, `platforms/market`. Each app keeps only its routes, templates, bootstrap, and env; features, stores, models, and shared logic live in `platforms/market`. + +## Alternatives +- One platform per app (`platforms/bull`, `platforms/bear`): duplicates the same business logic in two places. + +## Consequences +- Nx tags: both apps and the platform use `scope:market`, so each app may import `platforms/market`, and neither app imports the other. +- Models and actions must stay viewport-agnostic; device-specific UI belongs in each app's templates and organisms. +- One URL serves two apps (dynamic serving): both apps keep the same route paths, and nginx sends `Vary: User-Agent` so caches and search engines don't mix the two versions. diff --git a/docs/decisions/0002-island-layout-and-element-over-native-tags.md b/docs/decisions/0002-island-layout-and-element-over-native-tags.md new file mode 100644 index 0000000..4a89b63 --- /dev/null +++ b/docs/decisions/0002-island-layout-and-element-over-native-tags.md @@ -0,0 +1,22 @@ +# 0002 Island Element, FlexBox, and GridBox over native tags + +Status: Accepted · Area: design · Date: 2026-10-04 · Decided by: user + +## Context +Island has three typed atoms, `Element`, `FlexBox`, and `GridBox`, that render tags and layouts. The user set them as the only way to render tags and layouts. + +## Decision +- Render every HTML or SVG tag through island `Element` (``), never as native JSX (``, `
`, `