Welcome to KaziHaven β the ultimate job portal that connects job seekers with potential employers seamlessly. Whether you're looking for your dream job or seeking top talent, Kazi-Haven has got you covered! π―π
πLive Demo
The project is fully deployed and accessible online:
- Frontend: Live on Vercel
- Backend: Live on Render
You can use the following demo accounts to explore Kazi Haven. If you want to experience the full functionality, feel free to register your own account!
| Role | Password | |
|---|---|---|
| Recruiter | [email protected] | mark2006 |
| Student | [email protected] | mark2006 |
πΉ Note: Some features may be restricted to specific roles. Create an account to personalize your experience! π
Follow these steps to set up and run Kazi-Haven locally.
# Clone the repo
git clone https://github.com/lewiii254/Kazi-Haven.git
cd Kazi-Havencd backend
npm installcd ../frontend
npm installCreate a .env file inside the backend folder and add the following:
MONGO_URI=your-mongodb-connection-string
JWT_SECRET=your-jwt-secret
CLOUDINARY_CLOUD_NAME=your-cloudinary-cloud-name
CLOUDINARY_API_KEY=your-cloudinary-api-key
CLOUDINARY_API_SECRET=your-cloudinary-api-secretcd backend
npm run devcd ../frontend
npm startOpen your browser and go to:
http://localhost:5000
π Boom! Kazi-Haven is now up and running on your local machine. Start exploring! ππ₯
- π’ Job Listings: Browse, search, and filter jobs based on category, location, and salary.
- π₯ User Authentication: Secure login & registration using JWT authentication.
- π€ Apply for Jobs: Users can apply directly and track application status.
- π Employer Dashboard: Employers can post, manage, and edit job listings.
- π User Profiles: Personalized profiles for job seekers & recruiters.
- π° M-Pesa Integration: Secure and seamless payment for premium job listings.
- π Admin Panel: Manage users, job posts, and site analytics.
- Frontend: React.js (Vite) + Tailwind CSS
- Backend: Node.js + Express.js
- Database: MongoDB + Mongoose
- Authentication: JWT
- Hosting:
- Frontend: Vercel
- Backend: Render
Want to improve Kazi-Haven? Contributions are always welcome! π
- Fork the repository π΄
- Create a new branch:
git checkout -b feature-awesome - Commit your changes:
git commit -m 'Added an awesome feature' - Push to your branch:
git push origin feature-awesome - Open a Pull Request
This project is open-source and available under the MIT License.
πΉ Upcoming Features:
β Email notifications for job applications
β Advanced filtering & sorting
β User reviews & ratings
β AI-powered job recommendations
β Responsiveness in all devices
π‘ Have a question or suggestion? Let's connect!
- π LinkedIn:
- π¦ Twitter:
- π Portfolio:
π₯ KaziHaven β Connecting Talent with Opportunity! π₯
Here are some screenshots of Kazi Haven in action:
Feel free to explore the live platform and register your own account! πβ¨






