# NigeriaJobs

Job Posting Aggregator for Nigerian Job Seekers


Project Overview


This project is a web-based job posting aggregator designed to address the challenges faced by Nigerian job seekers. It automatically collects and consolidates job listings from multiple Nigerian job boards, presenting them in a single, user-friendly platform. The application saves users time and effort by eliminating the need to browse multiple websites for new opportunities. 
Features



Automated Web Scraping: Gathers job postings from major Nigerian job websites.
Centralized Database: Stores aggregated job listings in a structured MongoDB database.
Search and Filtering: Allows users to easily find jobs based on keywords, location, company, or category.
User-Friendly Interface: Provides a responsive and intuitive web interface for browsing job listings.
Automated Updates: A scheduled task ensures the job listings are kept fresh and up-to-date.
Robust Backend: Built with Node.js and Express to handle data scraping and serve the API.
Modern Frontend: Developed with React/Next.js and styled with Tailwind CSS for a modern, responsive design. 
Technologies



Frontend: React / Next.js, Tailwind CSS
Backend: Node.js, Express
Database: MongoDB (via Mongoose)
Scraping: Axios, Cheerio, Puppeteer
Automation: node-cron
Version Control: Git, GitHub



Project Structure
The repository follows a monorepo structure, housing both the frontend and backend of the application in separate directories for a clear separation of concerns.


job-aggregator/
│
├── .gitignore          # Excludes unnecessary files like node_modules and .env
├── README.md           # The file you are reading now
│
├── /frontend           # React/Next.js client-side application
│   ├── /components
│   ├── /pages
│   ├── /public
│   ├── /src
│   └── package.json
│
└── /backend            # Node.js/Express server with scraping logic
    ├── src/
    │   ├── /models       # Mongoose schemas for the database
    │   ├── /scrapers     # Logic for scraping different job sites
    │   ├── /routes       # API endpoints for fetching jobs
    │   └── server.js     # Entry point for the Express server
    └── package.json


How to Run Locally
Clone the repository:
sh
git clone https://github.com/your-username/job-aggregator.git
cd job-aggregator
Use code with caution.

Set up the backend:
sh
cd backend
npm install
# Create a .env file with your MongoDB connection string
npm run dev
Use code with caution.

Set up the frontend:
sh
cd ../frontend
npm install
npm start
Use code with caution.

Contribution
This is an open-source project. Feedback, bug reports, and contributions are welcome. Please refer to the CONTRIBUTING.md file (if you choose to create one) for more details.