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 | ngondimarklewis@gmail.com | mark2006 |
Student | student@gmail.com | 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-Haven
cd backend
npm install
cd ../frontend
npm install
Create 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-secret
cd backend
npm run dev
cd ../frontend
npm start
Open 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! πβ¨