Files
festipod/AGENTS.md
T
Sylvain Duchesne 708cbeead8 E2E testing infrastructure, NextGraph connection fixes, and documentation
- 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>
2026-03-13 17:51:44 +01:00

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