Bridge FEMM

Bridge

Client-side bridge: imports JSON exports from the FEMM Health App into HDS via direct browser upload (no server-side component).

Data Synced

• Cycle days, period bleeding, brown/dark coloration
• Cervical mucus observations (via the data-model cervical-fluid converter, FEMM v0 method)
• Basal body temperature (auto-converted F → °C when needed)
• Cycle phase, peak day, fertile window
• Sexual activity, LH and pregnancy test events
• Physical symptoms (cramps, headache, nausea, …)
• Emotional symptoms (anxiety, mood swings → mood vectors; cant_focus, insomnia → dedicated items)
• Custom medications with time-of-day placement
• User notes
• Profile metadata (cycle/period averages, FEMM-specific goal/stage)

Flow

1. User uploads a FEMM JSON export in the bridge webapp
2. Webapp authenticates to the user’s Pryv account via web auth flow
3. Browser parses the export, runs a diff against existing raw events, and lets the user preview new / changed / deleted entries
4. On confirm, raw raw-events/femm-day-v1 events are written and converted into standard HDS events

Tech Stack

• TypeScript conversion library (browser-friendly, no server)
• React 19 + Vite test webapp (forthcoming)
• Depends on hds-lib and data-model directly (no lib-bridge-js)

Status

In active development — see plan 33 in the macro workspace.