✨ A feature-rich job portal built with cutting-edge technologies to bridge the gap between talent and opportunity ✨
- 🏷️ Browse and filter thousands of job listings
- 📋 Detailed job descriptions with salary/benefits
- 🔎 Advanced search with keywords, location, and filters
- 📤 One-click resume/CV upload (PDF, DOC, DOCX)
- 📊 Track application status (Applied, Viewed, Interview)
- 🔖 Save favorite jobs for later
- 🔒 Secure login (Email + Google OAuth)
- 🧑💼 Personalized dashboard
- 🌓 Light/Dark mode toggle
- 📱 Fully responsive design
- ⚛️ React 18 (Vite)
- 🎨 Tailwind CSS + DaisyUI
- ✨ Framer Motion (Animations)
- 📦 React Hook Form + Yup
- 🔥 Firebase Firestore (Database)
- 🔐 Firebase Authentication
- ☁️ Firebase Storage (or AWS S3)
- ✉️ EmailJS (Notifications)
- ▲ Vercel
🅰️ AWS Amplify- 🔥 Firebase Hosting
- λ AWS Lambda (Serverless)
- Node.js (v18+)
- npm/pnpm/yarn
- Firebase account
# 1. Clone repository
git clone https://github.com/your-username/job-portal.git
cd job-portal
# 2. Install dependencies
npm install
# 3. Configure environment
cp .env.example .env
# Add your Firebase config
# 4. Run dev server
npm run dev
Open http://localhost:5173 in your browser 🌐
🚀 Deployment Guide
Frontend Hosting
Platform Guide
▲ Vercel Deploy with Vercel
🅰️ Amplify Connect repo in AWS Console
🔥 Firebase firebase init hosting
Backend Options
Firebase (Default) - Ready out-of-the-box
AWS Serverless - Requires Lambda + API Gateway setup
Hybrid - Firebase Auth + AWS S3 for resumes
🏗️ Project Structure
📦 job-portal
├── 📂 public
├── 📂 src
│ ├── 📂 api # API services
│ ├── 📂 components # UI components
│ ├── 📂 features # Feature modules
│ │ ├── 📂 auth # Auth flows
│ │ ├── 📂 jobs # Job listings
│ │ └── 📂 user # Profile/dashboard
│ ├── 📂 hooks # Custom hooks
│ └── ...
├── 📜 .env.example
└── 📜 package.json
🎨 Customization Tips
Branding
Modify colors in tailwind.config.js 🎨
Update logos in public/ folder
Job Fields
Edit src/features/jobs/jobSchema.js 📝
Add custom fields like "remote_ok"
Auth Providers
Enable GitHub/Apple auth in Firebase 🔐
🤝 How to Contribute
💖 First time contributing? Welcome!
🔧 Found a bug? Open an issue!
✨ Want a feature? Submit a PR!
Follow these steps:
Fork the repo 🍴
Create your branch git checkout -b feature/awesome
Commit changes git commit -m 'Add awesome feature'
Push git push origin feature/awesome
Open a Pull Request
📜 License
MIT © 2025
License: MIT
🙌 Credits
React Team ⚛️
Vite Core Team ⚡
Firebase Team 🔥
Tailwind CSS Authors 🎨