Skip to content

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! πŸŽ―πŸš€

Notifications You must be signed in to change notification settings

lewiii254/Kazi-Haven

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

28 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”—Kazi-Haven πŸš€πŸŒπŸ”₯

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:

πŸš€ Demo Accounts

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 Email 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! πŸš€


πŸš€ Getting Started

Follow these steps to set up and run Kazi-Haven locally.

1️⃣ Clone the Repository

# Clone the repo
git clone https://github.com/lewiii254/Kazi-Haven.git
cd Kazi-Haven

2️⃣ Install Dependencies

Backend Setup:

cd backend
npm install

Frontend Setup:

cd ../frontend
npm install

3️⃣ Set Up Environment Variables

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

4️⃣ Run the Project

Start the Backend:

cd backend
npm run dev

Start the Frontend:

cd ../frontend
npm start

5️⃣ Access the App

Open your browser and go to:

http://localhost:5000

πŸŽ‰ Boom! Kazi-Haven is now up and running on your local machine. Start exploring! πŸš€πŸ”₯


🌟 Features

  • 🏒 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.

πŸ›  Tech Stack

  • Frontend: React.js (Vite) + Tailwind CSS
  • Backend: Node.js + Express.js
  • Database: MongoDB + Mongoose
  • Authentication: JWT
  • Hosting:
    • Frontend: Vercel
    • Backend: Render

🀝 Contributing

Want to improve Kazi-Haven? Contributions are always welcome! πŸš€

  1. Fork the repository 🍴
  2. Create a new branch: git checkout -b feature-awesome
  3. Commit your changes: git commit -m 'Added an awesome feature'
  4. Push to your branch: git push origin feature-awesome
  5. Open a Pull Request

πŸ“ License

This project is open-source and available under the MIT License.


πŸ“… Roadmap

πŸ”Ή Upcoming Features:

βœ… Email notifications for job applications

βœ… Advanced filtering & sorting

βœ… User reviews & ratings

βœ… AI-powered job recommendations

βœ… Responsiveness in all devices


🎯 Connect With Me

πŸ’‘ Have a question or suggestion? Let's connect!

πŸ”₯ KaziHaven – Connecting Talent with Opportunity! πŸ”₯

πŸ“Έ Screenshots

Here are some screenshots of Kazi Haven in action:

πŸ”Ή Homepage

Homepage

πŸ”Ή Dashboard

Dashboard

πŸ”Ή Job Listing Page

Job Listing

πŸ”Ή Browse Page

image

πŸ”Ή SignUp Page

image

πŸ”Ή Profile Page

image

πŸ”Ή Companies Page

image

πŸ”Ή Jobs Page

image

Feel free to explore the live platform and register your own account! πŸš€βœ¨

About

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! πŸŽ―πŸš€

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published