Files
festipod/AGENTS.md
T
Sylvain Duchesne 6f9b3ece34 Data-layer BDD testing infrastructure and steps/frontend → steps/ui rename
- Rename steps/frontend/ to steps/ui/ across all modules and shared
- Add data-layer test harness (mock + real broker modes) with Playwright
- Add inscription data-layer steps (@data scenarios)
- Add test auth setup script and browser debug script
- Update docs (architecture, BDD testing, data-layer testing)
- Add ADR for headless wallet creation decision

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 18:01:46 +01:00

2.0 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 through the real NextGraph broker with 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