A clear, calm, and consistent daily Torah learning experience — without overload, guilt, or enforcement.
HaLomeid is an offline-first daily learning application designed for religious and traditional users who seek a consistent, calm, and meaningful Torah study habit. The app delivers a personalized learning path through the entire Mishnah, enhanced by AI-generated explanations grounded in classical Jewish commentaries.
- Full Shas Coverage — Complete learning path through all of Mishnah
- Customizable Pace — Choose from one mishna, two mishnayot, or one chapter per day
- Visual Progress — Beautiful timeline showing your journey through the tractates
- Tractate Celebrations — Celebrate when you complete each tractate
- Source Text — Original Hebrew Mishnah text displayed prominently
- AI Explanations — Clear summaries based on classical commentaries
- Commentary Summaries — Expandable sections with multiple interpretive approaches
- Halakha Sections — Practical applications where relevant
- Review Sessions — Configurable review intensity (none, light, medium, intensive)
- Weekly Quizzes — Every Friday, test your knowledge on the week's learning
- Multi-Question Quizzes — Up to 8 questions per quiz, generated by AI
- Offline-First — Full functionality without internet connection (RxDB + Supabase)
- PWA Support — Install on any device like a native app
- Dark Mode — Light, dark, and system theme options
- Hebrew UI — Full Hebrew interface with RTL support
| Layer | Technology |
|---|---|
| Frontend | Next.js 16, React 19, Tailwind CSS |
| Database | Supabase (PostgreSQL) |
| Sync | RxDB (offline-first with Supabase replication) |
| AI | Google Gemini (explanations & quizzes) |
| Auth | Supabase Auth (Anonymous, Google, Apple) |
| Hosting | Vercel |
| Analytics | PostHog |
halomed/
├── web/ # Next.js web application
│ ├── app/ # App Router pages
│ ├── components/ # React components
│ └── lib/ # Utilities & hooks
├── supabase/
│ ├── functions/ # Edge Functions (Deno)
│ └── migrations/ # Database migrations
├── docs/ # PRD & TDD documentation
├── tests/ # Maestro E2E tests
└── scripts/ # Development scripts
- Node.js 18+
- Supabase account
# Clone the repository
git clone https://github.com/orelzion/halomed.git
cd halomed
# Install git hooks (security & TypeScript checks)
./scripts/setup-hooks.sh
# Install web dependencies
cd web
npm install
# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your credentials
# Start development server
npm run dev# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
# PostHog (optional)
NEXT_PUBLIC_POSTHOG_KEY=your-posthog-key
NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.comThe project includes automatic checks:
- Pre-commit: Security scanning for secrets and API keys
- Pre-push: TypeScript type checking
Install hooks with:
./scripts/setup-hooks.shcd supabase
supabase functions deploy generate-path --use-api --no-verify-jwt
supabase functions deploy generate-quiz --use-api --no-verify-jwt
supabase functions deploy generate-content --use-api --no-verify-jwt# E2E tests with Maestro
maestro test tests/maestro/flows/web/
# TypeScript check
cd web && npx tsc --noEmit- Product Requirements (PRD) — Product vision and features
- Technical Design (TDD) — Architecture and implementation details
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is private and not open for public use without permission.
- Hebrew Wikisource (ויקיטקסט) — Mishnah source text
- Sefaria — Commentaries and Torah texts API
- RxDB — Offline-first reactive database
- Supabase — Backend infrastructure
- Vercel — Hosting platform
הַלּוֹמֵד וְאֵינוֹ חוֹזֵר — כְּזוֹרֵעַ וְאֵינוֹ קוֹצֵר
סנהדרין צט ע"א