A modern full-stack job portal web application built with Django, connecting job seekers with recruiters through a clean, responsive interface with role-based dashboards and real-time application tracking.
🌐 Live Demo: https://worksnest.onrender.com
- Browse and search job listings by title, type, and location
- Apply to jobs with a cover letter and resume
- Track application status in real time — Applied → Reviewing → Shortlisted → Hired / Rejected
- Save jobs for later
- Personal profile with skills, bio, resume and social links
- Post, edit, and manage job listings
- Company profile with logo and description
- View all applications per job listing
- Update applicant status with one click
- Dashboard with stats on active jobs and total applications
- Role-based registration — Job Seeker or Recruiter
- Secure login and logout
- Responsive design — works on mobile and desktop
- Dark navy UI with teal accents and smooth animations
- Flash notifications for all actions
| Layer | Technology |
|---|---|
| Backend | Django 6.0 |
| Language | Python 3.14 |
| Database | SQLite (dev) / PostgreSQL (production) |
| Frontend | HTML, CSS, Vanilla JavaScript |
| Auth | Django built-in authentication |
| Server | Gunicorn (WSGI) |
| Static Files | Whitenoise |
| Deployment | Render.com |
xproject/
├── WorksNest/ # Project config (settings, urls, wsgi)
├── core/ # Main app
│ ├── templates/
│ │ ├── core/ # All page templates
│ │ └── registration/ # Login and register templates
│ ├── templatetags/ # Custom template filters
│ ├── models.py # Profile, Company, Job, Application, SavedJob
│ ├── views.py # All views
│ ├── urls.py # URL routing
│ ├── forms.py # Django forms
│ └── admin.py # Admin configuration
├── static/ # CSS and JS
├── media/ # User uploads
├── requirements.txt
├── Procfile
├── runtime.txt
└── manage.py
git clone https://github.com/DSBaibhav/WorksNest.git
cd WorksNestpython3 -m venv venv
source venv/bin/activate # Mac/Linux
venv\Scripts\activate # Windowspip install -r requirements.txtSECRET_KEY=your-secret-key-here
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
DATABASE_URL=sqlite:///db.sqlite3python manage.py makemigrations
python manage.py migratepython manage.py createsuperuserpython manage.py runserverVisit http://127.0.0.1:8000
This project is deployed on Render.com using:
- Gunicorn as the production WSGI server
- Whitenoise for serving static files
- PostgreSQL as the production database
SECRET_KEY → your-generated-secret-key
DEBUG → False
ALLOWED_HOSTS → yourappname.onrender.com
DATABASE_URL → postgresql://... (from Render PostgreSQL)
pip install -r requirements.txt && python manage.py collectstatic --noinput && python manage.py migrate
gunicorn WorksNest.wsgi
| Page | URL |
|---|---|
| Home | / |
| Browse Jobs | /jobs/ |
| Job Detail | /jobs/<id>/ |
| Register | /register/ |
| Login | /login/ |
| Dashboard | /dashboard/ |
| Profile | /profile/ |
| Post a Job | /recruiter/jobs/new/ |
| Company Profile | /recruiter/company/ |
| My Applications | /seeker/applications/ |
| Saved Jobs | /seeker/saved/ |
| Admin Panel | /admin/ |
Job Seeker
- Can browse, search, apply and save jobs
- Has personal profile with resume upload
- Can track application status in real time
Recruiter
- Can post and manage job listings
- Has company profile with logo
- Can review applications and update their status
DSBaibhav
- GitHub: @DSBaibhav
- Github: @AakrityMishra
This project was collaboratively built by:
- Baibhav Singh – Lead Developer, Architecture, Core Implementation
- Aakrity Mishra – Logic Development, Feature Support, Testing
©️ 2026 WorksNest. All rights reserved.