An AI-powered chatbot helping South African students navigate university applications, bursaries, and student readiness, no login, no setup, just ask.
# Bridge the Gap π
> An AI-powered chatbot helping South African students navigate university applications, bursaries, and student readiness, no login, no setup, just ask.
---
## β¨ About
**Bridge the Gap** is a friendly, supportive academic mentor built for students in South Africa. It answers FAQs about:
- π« **Universities** β choosing where to apply
- π **Applications** β process, documents, deadlines
- π° **Bursaries** β funding options, eligibility
- π― **Student success & readiness** β preparing for higher education
The bot acts like a trusted mentor: clear, motivational, realistic, and always nudging the user toward a concrete next step.
---
## π Live Demo
Open the app and start chatting β no signup required.
Link:
hope-hub-za.lovable.app
---
## π§© Key Features
| Feature | Description |
|---|---|
| **No login required** | Open the page and start chatting immediately. |
| **Streaming responses** | Replies appear word-by-word for a natural feel. |
| **Session-based chat** | Conversations live in-memory and reset on refresh or "New chat". |
| **Mentor persona** | Consistent tone β clear, motivational, locally relevant to South Africa. |
| **Mandatory greeting** | Standard opening response when the user says "Hi" / "Hello". |
| **Anti-hallucination guardrails** | Will not invent APS scores, deadlines, or bursary criteria. |
| **Topic guardrails** | Off-topic questions are gently redirected back to core areas. |
---
## ποΈ Architecture
1. The user types a question in the chat composer.
2. The React app sends the full message history to the `chat` edge function.
3. The edge function injects the **Bridge the Gap** system prompt and forwards the request to the Lovable AI Gateway.
4. The AI response is streamed back as Server-Sent Events and rendered token-by-token.
---
## π οΈ Tech Stack
- **Frontend:** React 18, Vite, TypeScript, Tailwind CSS, shadcn/ui
- **Backend:** Lovable Cloud (Supabase) Edge Function (Deno)
- **AI Provider:** Lovable AI Gatew β¦