708cbeead8
- Add @e2e test layer: real app in broker iframe via Playwright - Fix broker redirect: conditional auto-init only when inside iframe - Fix seed data flash: empty data during 'connecting' phase - Fix Gallery button in iframe: explicit navigate instead of history.back - Add auth e2e feature scenarios and step definitions - Update docs: bdd-testing, data-layer-testing, data-layer, AGENTS.md - Add decision record for conditional NG init approach Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.1 KiB
2.1 KiB
Festipod
Prototyping tool for a mobile festival/event app — mockup screens, user stories, and BDD specs.
Two Apps in One
| Layer | Tech | Purpose |
|---|---|---|
| Festipod App (mockups) | React + sketchy components | 16 mobile screens with hand-drawn UI |
| Prototyping Tool (shell) | React + Tailwind/Shadcn | Gallery, demo viewer, BDD specs browser |
Architecture
Feature-based: code organized by business domain, not technical layer. See architecture.
src/modules/{event,user,home,auth,workshop,meeting,notification}/
src/shared/ # Components, context, data — importable by all modules
src/app/ # Prototyping tool shell
src/screens/index.ts # Screen registry
Data Layer
NextGraph (P2P/local-first) with SHEX shapes and ORM. See data-layer.
BDD Testing
Multi-layer Cucumber/Gherkin in French. See bdd-testing.
@data scenarios test data operations through the real NextGraph broker. @e2e scenarios test the real app UI in the broker iframe. Both use Playwright. See data-layer-testing.
Quick Start
bun run dev # Dev server with HMR (port 3000)
bun run build # Production build to dist/
bun run test:cucumber # Run all BDD tests
bun run features:parse # Regenerate features.ts from .feature files
bun run steps:extract # Extract step definitions for tooltips
bun run build:orm # Regenerate ORM from SHEX shapes
Documentation
- Architecture — module structure, import rules, app shell
- Data Layer — NextGraph, shapes, context, seed data
- BDD Testing — Cucumber setup, step layers, feature files
- Screens — screen inventory, registry, sketchy components
- Data-Layer Testing — real broker testing, wallet setup, Playwright harness, e2e layer