Jobs and scholarships platform for Nigerians - auto-updated daily via web scraper. Built with Next.js, Supabase, and Python.
# π³π¬ NaijaOpportunities
> **The #1 platform for Nigerian students and job seekers** β fresh jobs and scholarships, updated daily, all in one place.
π **Live Site:** naija-opportunities.vercel.app
---
## β¨ What it does
NaijaOpportunities automatically scrapes the web every 6 hours to bring you:
- πΌ **Latest Nigerian jobs** β from Jobberman, MyJobMag, and more
- π **Scholarships for Nigerians** β local and international opportunities
- π€ **PathSync AI integration** β AI-powered scholarship matching for students
Every listing gets its own shareable page β perfect for WhatsApp and social media sharing.
---
## π οΈ Tech Stack
| Layer | Tech |
|---|---|
| Frontend | Next.js 15 + TypeScript |
| Styling | Tailwind CSS |
| Database | Supabase (PostgreSQL) |
| Scraper | Python + BeautifulSoup |
| Hosting | Vercel |
| Auto-update | GitHub Actions (every 6hrs) |
---
## π Features
- β‘ Server-side rendered pages (great for SEO)
- π Auto-scraping from multiple sources daily
- π± Mobile responsive
- π Shareable individual pages for each job/scholarship
- π€ PathSync AI banner on every page
- π‘οΈ Row-level security on Supabase
---
## π Project Structure
```
naija-opportunities/
βββ app/
β βββ page.tsx # Homepage
β βββ jobs/
β β βββ page.tsx # Jobs listing
β β βββ [slug]/page.tsx # Individual job page
β βββ scholarships/
β β βββ page.tsx # Scholarships listing
β β βββ [slug]/page.tsx # Individual scholarship page
β βββ lib/
β βββ supabase.ts # Supabase client
βββ scraper/
β βββ scraper.py # Python web scraper
βββ .github/
βββ workflows/
βββ scraper.yml # Auto-scraping workflow
```
---
## π§ Getting Started
### 1. Clone the repo
```bash
git clone
github.com
cd naija-opportunities
```
### 2. Install dependencies
```bash
npm install
```
### 3. Set up environment variables
Create a `.env.local` file:
```
NEXT_ β¦