South Africa's AI-powered Career Intelligence Platform
# CareerIntel SA — AI Career Intelligence Platform
> South Africa's first AI-powered career intelligence engine. Built to solve graduate unemployment, skills mismatch, and the lack of accessible labour market intelligence for ALL South Africans — from university graduates to artisans and trade workers.
- **GitHub:** Sabelo-K/career-intel-sa
- **Hosting:** Vercel (frontend) + Supabase (database)
- **AI Model:** Groq `llama-3.3-70b-versatile` (free tier — no credit card required)
---
## Table of Contents
1. Quick Start
2. Project Vision
3. Features
4. Architecture
5. Tech Stack
6. Folder Structure
7. Database Schema
8. Environment Variables
9. Deployment Guide
10. AI Integration
11. SA Career Data
12. Pricing Model
13. Design Principles
14. Roadmap
15. Build Log
16. Known Issues & Pending Work
---
## Quick Start
```bash
# 1. Clone & install
git clone
github.com
cd career-intel
npm install
# 2. Set up environment
cp .env.example .env
# Fill in your keys (see Environment Variables section)
# 3. Set up database
npx prisma db push
npm run db:seed
# 4. Start dev server
npm run dev
```
Open
localhost
---
## Project Vision
South Africa has a 32%+ unemployment rate, with graduates facing a severe mismatch between their skills and what employers actually need. CareerIntel SA addresses this by providing:
- **Real SA labour market data** — not generic global stats, but actual demand, salaries, and growth trends for SA careers
- **AI-powered personalisation** — every recommendation is tailored to the user's specific background
- **Inclusivity** — covers trades and artisan careers (Electricians, Plumbers, Welders) alongside knowledge-worker roles, reflecting the true SA economy
- **Affordability** — tiered pricing starting at R0 so no one is excluded
---
## Features
All 8 feature pages live under the authenticated `/dashboard` route.
### 1. AI CV Builder (`/cv-builder`)
Two-mode builder with game-changing AI reva …