💼 JobFinder

A Django-powered Job Finding Platform that mimics a real-world job board with authentication, favorites, search filters, and more.

---

📌 Overview

JobFinder is a web application built with Django that allows users to browse, filter, and save job postings.

This project is ideal for:

• 🎓 Developers learning Django fundamentals (authentication, views, templates, models).
• 🏢 Employers/Recruiters who want to manage job postings.
• 🔎 Job Seekers looking for a structured, user-friendly job search experience.

---

✨ Features

• 🔐 User Authentication – Sign up, log in, log out, and change password.
• ⭐ Favorites – Save jobs to a personalized favorites list.
• 🔎 Advanced Search & Filters – Search by keyword and filter by city (with “All cities” option).
• 📄 Pagination – Browse jobs in sets of 80 per page.
• 📱 Responsive UI – Clean layout with intuitive navigation.
• 🛡 Secure by Design – Implements Django’s security best practices (CSRF, CSP considerations).

---

⚙️ Installation & Setup

1. Clone the Repository

   git clone https://github.com/mbabaj/jobfinder.git
   cd jobfinder

2. Create a Virtual Environment

   python -m venv venv
   source venv/bin/activate   # Linux/Mac
   venv\Scripts\activate      # Windows

3. Install Dependencies

   pip install -r requirements.txt

4. Apply Migrations

   python manage.py migrate

5. Run the Development Server

   python manage.py runserver

---

🖼 Screenshots

Home Page

Login Page

Sign Up Page

Change Password

Dropdown Menu

Favorites Page

Pagination Buttons

---

🔧 Configuration

Create a .env file in the root directory and configure the following:

SECRET_KEY=your-django-secret-key
DEBUG=True
ALLOWED_HOSTS=127.0.0.1,localhost

---

📜 License

This project is licensed under the MIT License – feel free to use, modify, and distribute it.

---

🚀 Future Improvements

• ✅ API support with Django REST Framework
• ✅ Role-based access (e.g., recruiters vs. job seekers)
• ✅ Job application tracking system

---