Logo Lanfrica

GoodnessOni/naija-opportunities

Domain:

socioeconomic
Creator:
Goo
Host:
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_ …