Healthtech is a modular, open-source healthcare management platform designed to help clinics, laboratories, and healthcare centres across Africa digitize their workflows efficiently.
Problems it solves:
- Paper-based patient records
- Inefficient appointment systems
- Poor laboratory workflow management
- Expensive proprietary healthcare software
| Layer | Technology |
|---|---|
| Framework | Next.js 15 (App Router) |
| Language | TypeScript |
| Styling | Tailwind CSS |
| Components | shadcn/ui |
| State | Zustand |
| Forms | React Hook Form + Zod |
| HTTP | Axios |
- Node.js 18+
- npm
- Clone the repository
git clone https://github.com/YOUR_USERNAME/healthtech.git
cd healthtech- Install dependencies
npm install- Set up environment variables
cp .env.example .env.local- Run the development server
npm run dev- Open your browser http://localhost:3000
| Folder | Description |
|---|---|
src/app/(auth)/ |
Login and register pages |
src/app/(dashboard)/ |
All dashboard pages |
src/components/layout/ |
Sidebar and top header |
src/components/shared/ |
Reusable components used across features |
src/features/auth/ |
Auth forms, services and types |
src/features/patients/ |
Patient components, services and types |
src/features/appointments/ |
Appointment components, services and types |
src/features/laboratory/ |
Lab components, services and types |
src/hooks/ |
Custom React hooks |
src/lib/ |
Axios instance and mock data |
src/store/ |
Zustand global state |
src/types/ |
Global TypeScript interfaces |
src/utils/ |
Helper functions |
Each feature in
src/features/follows the same structure:components/,hooks/,services/,types/, andindex.ts. Pick a feature folder and everything you need is inside it.
| Module | Status | Description |
|---|---|---|
| Authentication | ✅ Done | Login, register, route protection |
| Doctor Dashboard | ✅ Done | Appointments, stats, lab results, tasks |
| Patients | 🚧 In Progress | Registration, profiles, medical history |
| Appointments | 📅 Planned | Scheduling, calendar, queue |
| Laboratory | 📅 Planned | Test requests, results, reports |
| Pharmacy | 📅 Future | Medication management |
| Billing | 📅 Future | Payments and invoices |
We welcome contributions from developers of all skill levels!
Please read our CONTRIBUTING.md guide before submitting a pull request.
Good first issues are labeled: good first issue and beginner friendly
Please read our CODE_OF_CONDUCT.md before participating in our community.
This project is licensed under the MIT License — see the LICENSE file for details.