naimboughattas/amharic-storybook

# Storybook Amharique MVP Expo mobile app that helps mothers read bedtime stories in Amharic to their children, with no account, backend, ads, analytics, or remote storage. ## Commands ```sh npm install npm run start npm run web npm run build npm run typecheck npm run lint npm test npm run content:check npm run illustrations:check ``` `typecheck`, `lint`, `test`, and `content:check` are the four gates run by CI on every push and pull request (`.github/workflows/ci.yml`). The project was generated with Expo SDK 57. React Native 0.86 emits a warning when Node is outside the supported ranges (`^20.19.4`, `^22.13.0`, `^24.3.0`, or `>=25.0.0`). ## Repository Language Documentation, code comments, and commit messages must be written in English. Product copy may still be localized in French and English when it is user-facing or part of the bilingual story experience. ## Vercel Web Deployment Vercel should run `npm run build` and serve the generated `dist` directory. The `vercel.json` rewrite sends deep links such as `/story/:id` back to `/index.html`, which lets Expo Router restore the screen on refresh or shared links. ## Structure ```txt app/ _layout.tsx index.tsx story/[id].tsx components/ reader/ # reader header, page, dock, details sheet data/ features/progress/ public/ theme/ types/ docs/content-guidelines.md docs/bedtime-product-plan.md docs/catalog-audit.md docs/mobile-ui-direction.md docs/i18n-translation-plan.md ``` ## MVP Features - Bedtime-oriented home screen with a "Tonight" recommendation. - Home menu split between Tonight, Library, and Progress. - French / English interface for every non-Amharic user-facing text. - Library filterable by level. - Full-screen Ritual Mode reader, with Amharic as the main reading scene. - Thumb-friendly floating dock: previous, pause/resume, next, and info. - Bedtime reading guide: time left, narration tip, and pause ritual. - Local progress: completed stories, favorites, last page, theme, and language. - …