A full-stack healthcare management system built with React (Vite) and Express.js, backed by PostgreSQL.
This platform is designed to streamline clinic operations by enabling receptionists to register clients and doctors to manage health programs and assign them to individual clients.
- Register new clients with full name, phone number, and ID
- View and search all registered clients
- Intuitive modal interface for adding clients
- Create and manage health programs (e.g., TB, HIV, Malaria)
- Assign one or multiple programs to each client
- View and search through assigned client programs
- Clean UI design with soft gray and muted blue (
#8DABCE) theme for low eye strain
/frontend # Frontend (React with Vite)
/backend # Backend (Express.js)
/backend(pg admin) # SQL setup (tables and seed data)
- Frontend: React (Vite), Bootstrap
- Backend: Express.js, Node.js
- Database: PostgreSQL
- Other Tools: Vite, pg, bcrypt, dotenv, cors
-
Navigate to the backend directory:
cd backend -
Install dependencies:
npm install
-
Start the server:
node server.js
The backend will run on:
http://localhost:8000
-
Navigate to the frontend directory:
cd frontend -
Install dependencies:
npm install
-
Run the development server:
npm run dev
The frontend will run on:
http://localhost:5173
This project was developed as part of an interview assignment and serves as a portfolio piece demonstrating:
- Full-stack development (React + Express)
- Relational database design with PostgreSQL
- Security features such as password hashing and role authorization.
- RESTful API architecture
- UI/UX best practices
- Vite-based frontend tooling
Made with 💙 by Charity Nyamamba
- 📧 Email: nyamambanyaguch@gmail.com
- 🌐 LinkedIn: Charity
Receptionist HomepageDashboard
Recetionist Add Clients Functionality
Clients from receptionist's page
Doctor's homepage
Doctor's health programs
Client's view from doctor's page





