Bridge Cycles Files

BridgeDemo

Demo: 882fedc (Jun 29, 2026)Prod: 882fedc (Jun 29, 2026)

Browser-side bridge that imports cycle-tracking data from multiple source apps into HDS via direct file upload. Each supported format has its own adapter mounted at a dedicated route; the host app handles auth, diffing, preview and write.

Supported formats

Route	Source	Status
/femm	FEMM Health App JSON export	Production (replaces standalone bridge-femm)
/cyclefem	cyclefeminin.net JSON export	Production (replaces standalone bridge-cyclefeminin-net); supports sympto-thermal, Billings (BOM) and Creighton 9D vectors
/ryb	Read Your Body JSON export	v0.1 — BBT, intercourse, LH AM/PM, pregnancy + progesterone tests, notes, raw cycle/day provenance events. Mucus / cervix / photos / custom_lines deferred.

Flow (per adapter)

1. User uploads a JSON export at the adapter route
2. Adapter authenticates to the user’s Pryv account via web auth flow
3. Browser parses the export, runs a diff against existing raw events, lets the user preview new / changed / deleted entries
4. On confirm, raw events are written under the adapter-specific stream, then converted into standard HDS events
5. Pryv createdBy / modifiedBy attributes the source correctly so the same patient can import from several apps without conflicts

Tech Stack

• React 19 + Vite + Tailwind 4
• TypeScript conversion library (browser-only, no server)
• Depends on hds-lib, data-model, hds-style
• Per-adapter FormatAdapter contract makes adding a new source format an isolated change

Status

Production. Shipped 2026-05-29 (plan 65). Replaces the standalone bridge-femm and bridge-cyclefeminin-net apps — both legacy gh-pages now serve a redirect to the matching route here.