🔥 IgniteX - Job Portal

Where Ambition Sparks Opportunity

A modern, full-stack job portal application built with the MERN stack, featuring an elegant dark theme and a clean, professional user interface.

🚀 Features

For Job Seekers

🔍 Smart Job Search - Search jobs by title, location, or description
🎯 Advanced Filters - Filter by industry, work type, and location
📱 Responsive Design - Seamless experience across all devices
💼 Job Applications - Easy one-click apply to jobs
� Bookmark Jobs - Save jobs for later with persistent localStorage
💾 Saved Jobs Page - View all your bookmarked jobs in one place
�👤 Profile Management - Update profile, resume, and skills
📊 Application Tracking - Track all your job applications

For Recruiters

🏢 Company Management - Create and manage company profiles
✍️ Post Jobs - Easy job posting with detailed descriptions
📋 Applicant Management - Review and manage job applications
📈 Dashboard - View all posted jobs and applicants
🎨 Rich Job Listings - Add requirements, salary, location, and more

Design Highlights

🎨 Modern UI/UX - Clean, professional design with smooth animations
🌓 Dark/Light Mode - Toggle between elegant dark and light themes
✨ Smooth Animations - Framer Motion powered transitions
🎨 Color Palette - Purple (#7209b7), Orange (#F83002), and Blue accent colors
💾 localStorage Integration - Persistent bookmarks across sessions

🛠️ Tech Stack

Frontend

React 18+ - Modern React with Hooks
Vite - Lightning-fast build tool
Redux Toolkit - State management
React Router v6 - Client-side routing
Tailwind CSS - Utility-first styling
Framer Motion - Smooth animations
Shadcn/ui - High-quality UI components
Lucide React - Beautiful icons
Axios - HTTP client

Backend

Node.js - Runtime environment
Express.js - Web application framework
MongoDB - NoSQL database
Mongoose - MongoDB object modeling
JWT - Authentication & authorization
Bcrypt - Password hashing
Cloudinary - Image/file storage
Cookie Parser - Cookie handling
Multer - File upload handling
Dotenv - Environment variables

📁 Project Structure

project-new/
├── backend/
│   ├── controllers/      # Request handlers
│   ├── models/           # Database schemas
│   ├── routes/           # API routes
│   ├── middlewares/      # Auth & error handling
│   ├── utils/            # Helper functions & DB
│   └── index.js          # Entry point
│
├── frontend/
│   ├── src/
│   │   ├── components/   # React components
│   │   │   ├── admin/    # Recruiter dashboard
│   │   │   ├── auth/     # Login/Signup
│   │   │   ├── shared/   # Navbar, Footer
│   │   │   └── ui/       # Reusable UI components
│   │   ├── hooks/        # Custom React hooks
│   │   ├── redux/        # State management
│   │   ├── utils/        # Constants & helpers
│   │   ├── App.jsx       # Main app component
│   │   └── index.css     # Global styles
│   └── public/           # Static assets
│
└── README.md

🚀 Getting Started

Prerequisites

Node.js (v16 or higher)
MongoDB (local or Atlas)
npm or yarn

Installation

Clone the repository

git clone <repository-url>
cd project-new

Backend Setup

cd backend
npm install

Create .env file in backend folder

PORT=3000
MONGO_URI=your_mongodb_connection_string
SECRET_KEY=your_jwt_secret_key
CLOUD_NAME=your_cloudinary_cloud_name
API_KEY=your_cloudinary_api_key
API_SECRET=your_cloudinary_api_secret

Frontend Setup

cd ../frontend
npm install

Run the Application

Terminal 1 - Backend:

cd backend
npm run dev

Terminal 2 - Frontend:

cd frontend
npm run dev

Open in Browser

http://localhost:5173

🎨 Color Palette

IgniteX Theme

Primary (Indigo): #6366F1 - Main brand color
Secondary (Teal): #14B8A6 - Cool accent
Accent (Purple): #A855F7 - Refined highlight

Light Mode

Background: Pure White (#FFFFFF)
Foreground: Slate-900 (#0F172A)
Cards: White with subtle shadows

Dark Mode

Background: Slate-900 (#0F172A)
Foreground: Slate-100 (#F1F5F9)
Cards: Slate-800 with glow effects

📚 API Endpoints

User Routes

POST /api/v1/user/register - Register new user
POST /api/v1/user/login - User login
GET /api/v1/user/logout - User logout
POST /api/v1/user/profile/update - Update profile

Job Routes

GET /api/v1/job/get - Get all jobs
GET /api/v1/job/get/:id - Get job by ID
POST /api/v1/job/post - Post new job (recruiter)
GET /api/v1/job/getadminjobs - Get recruiter's jobs

Job Features

🔖 Bookmark System - Save jobs to localStorage
💾 Saved Jobs Page - /saved-jobs route to view bookmarked jobs
✅ Visual Feedback - Icon changes when job is bookmarked
🔄 Persistent Storage - Bookmarks survive page refreshes

Company Routes

POST /api/v1/company/register - Register company
GET /api/v1/company/get - Get all companies
GET /api/v1/company/get/:id - Get company by ID
PUT /api/v1/company/update/:id - Update company

Application Routes

POST /api/v1/application/apply/:id - Apply to job
GET /api/v1/application/get - Get user's applications
GET /api/v1/application/:id/applicants - Get job applicants
POST /api/v1/application/status/:id/update - Update status

🔐 Authentication

The application uses JWT (JSON Web Tokens) for authentication:

Tokens stored in HTTP-only cookies
Protected routes for authenticated users
Role-based access (Job Seeker vs Recruiter)

📸 Screenshots

Home Page

Hero section with search
Category carousel
Latest job listings
Modern clean design with gradient backgrounds

Job Listings

Advanced filtering (Location, Industry, Salary)
Real-time search
Beautiful job cards with bookmark functionality
3-column grid layout
Save for later button

Saved Jobs Page

View all bookmarked jobs
Persistent storage with localStorage
Same filtering and search capabilities
Job count display
Empty state for no saved jobs

Dashboard (Recruiter)

Company management
Job posting
Applicant tracking
Analytics overview

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License.

👨‍💻 Developer

IgniteX - Built with passion and by Dishi Gupta and Ishi Bhavsar

🙏 Acknowledgments

Shadcn/ui - For beautiful UI components
Tailwind CSS - For utility-first styling
Framer Motion - For smooth animations
Lucide Icons - For clean, modern icons
Cloudinary - For file storage solution

📧 Contact

For questions or support, please reach out:

Email: ishibhavsar41@gmail.com, dishigpt15@gmail.com
GitHub: https://github.com/Ishibhavsar, https://github.com/DishiGpt

✅ Recent Updates

Bookmark & Save Jobs Feature (Latest)

✅ localStorage Integration - Jobs bookmarked persist across sessions
✅ Saved Jobs Page - Dedicated page to view all saved jobs
✅ Bookmark Icon - Click to bookmark/unbookmark jobs
✅ Save For Later Button - Quick save with visual feedback
✅ Navbar Link - Easy access to saved jobs from navigation
✅ Empty State UI - Friendly message when no jobs are saved
✅ Auto-fetch Jobs - Saved jobs page fetches all jobs on mount

🔮 Future Enhancements

Made with 🔥 by IgniteX Team

Where Ambition Sparks Opportunity 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 39 Commits
.github/workflows		.github/workflows
backend		backend
frontend		frontend
DEPLOYMENT.md		DEPLOYMENT.md
DEPLOYMENT_TROUBLESHOOTING.md		DEPLOYMENT_TROUBLESHOOTING.md
GITHUB_DEPLOYMENT.md		GITHUB_DEPLOYMENT.md
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation