4.6 KiB
Product implementation record
Scope
The public Astro website now lives in website/, preserving its source, assets,
brand references and hosting identity. backend/ describes the proposed BFF
boundary; no backend service is implemented.
The frontend includes:
sxchnge_theme: reusable Flutter theme, Onest font/license, light/dark themes, and a consumer example. UI uses ColorScheme and TextTheme roles.sxchnge_auth: shared login, signup, and email-verification contracts, models, providers, and deterministic dummy services, reusable on mobile.app: responsive login/signup, EN/RU localization and saved locale, email-sent and verified screens, expired/invalid/internal-error outcomes, resend/retry, and centralized go_router navigation.
Review boundaries and task mapping
The accumulated work was initially left uncommitted across task branches. Delivery groups the actual final code into three stacked contributions, without claiming that the earlier intermediate implementations were committed:
theme-1intomain: website relocation, repository scaffolding and theme. Related task: #1.auth-4intotheme-1: shared auth and verification package. Related tasks: #4, #5.routing-6intoauth-4: integrated application, root test entry point, self-contained frontend guidelines/workflow skills and this delivery record. Related tasks: #2, #3, #5, #6.
Review and merge in that order. Preserve commit ancestry with merge commits,
then retarget the next PR to main after its dependency merges. With squash
merges, rebase the remaining stack before merging. PR links are recorded below
once created. Earlier empty task branches are retained for traceability.
Validation
The frontend suite covers 56 tests: 20 shared auth, 3 theme, 3 theme consumer, and 30 app tests. Coverage includes validation, localized layouts at 200% text scale, provider lifecycle/race handling, signup through email confirmation, resend/retry, token changes, transient history extras and URL route updates.
Commands used for delivery:
- Root:
make test-frontend. - Flutter packages: formatting checks and
flutter analyze. - App:
flutter build web --no-wasm-dry-run. - Website:
npm run test,npm run check,npm run build.
The localhost preview was manually checked for confirmation deep-link reload, return to login, and browser back/forward. Tests and builds are local validation; no remote CI outcome is implied. Build outputs and dependency caches are ignored.
Current limitations
Authentication and verification are explicitly simulated. No real account,
session, email delivery, backend token validation or KYC access guard exists.
The three app routes are public; backend authorization remains future work.
demo-valid, demo-expired and demo-internal are preview-only confirmation
values. Other/missing tokens display invalid confirmation. Signup email is
transient and excluded from serialized browser history. Only locale preference
is persisted by the application.
The website and Flutter app are separate applications. The Flutter app currently has a web runner; the shared packages can be consumed by a future mobile app.
Published PRs
| Order | PR | Branch → base | Implementation commit |
|---|---|---|---|
| 1 | #7: Product layout and theme | theme-1 → main |
d931805 |
| 2 | #8: Shared auth and verification | auth-4 → theme-1 |
27424ed |
| 3 | #9: Localized app and routing | routing-6 → auth-4 |
10a278c |
All three implementation commits are pushed. PRs are open, assigned to tech,
labeled frontend, and associated with the SXCHNGE project. Follow-up documentation
commits are included in PR #9. Task references point to the delivering branches;
older empty branches are historical only. No PR has been merged during delivery.
Delivery validation passed: 56 frontend tests; formatting and all four Flutter analyses; 3 website tests, Astro check (zero errors/warnings), and website build. The app web build and browser checks passed during the immediately preceding routing task; delivery changed documentation and Git organization only.