# Ready Together
Ready Together is a responsive, story-driven maternal and newborn health learning prototype for families in Kenya. It is designed for two or more family members to use together on one phone at home.
## Run locally
Requirements: Node.js 20 or later and npm.
```bash
npm install
npm run dev
```
Open the local URL printed by Vite.
## Production build
```bash
npm run build
npm run preview
```
The production output is written to `dist/`.
## Project structure
```text
src/
components/ Reusable story, decision, plan, and accessibility UI
context/ Theme, text-size, and reduced-motion preferences
data/content.ts Editable educational copy, choices, explanations, and checklist data
App.tsx Story flow and branching state
styles.css Tailwind entry plus the responsive visual system
public/images/ Optimized WebP story illustrations
PRODUCT.md Durable product context
DESIGN.md Visual design-system contract
.impeccable/ Design-system sidecar and route brief
```
## Replace medically reviewed content
Edit `src/data/content.ts`. The scene labels, assumption statements, explanations, story choices, consequences, checklist items, and professional-review notice are stored as structured data rather than embedded in presentation components.
Before public use:
1. Ask qualified Kenyan maternal-health professionals to review every statement and recommended action.
2. Replace the placeholder review notice only after that review is complete.
3. Keep the experience non-diagnostic. Do not add medical history fields or automated conclusions.
4. Add Kiswahili as a separate locale data module with the same object shapes. Keep components locale-neutral.
## Replace images
Keep the existing filenames to replace artwork without changing code:
- `family-home-night.webp`: opening scene
- `readiness-table.webp`: preparation overview
- `community-plan …