Nexus-Digital-Solutions-ZM/satoshi-quest-zambia
Domaine:
natural language processingType de record:
software
Créateur:
Nex
Hôte:
⚡ Gamified Bitcoin (Lightning) quest platform for Zambia. Earn sats by completing real-world and digital challenges.
**Gamified Bitcoin education for Zambia — Learn in English & Bemba, Earn Sats**
SatoshiQuest is a mobile-first Progressive Web App (PWA) that teaches Bitcoin and Lightning Network concepts through gamified lessons and quizzes — built specifically for the Zambian context, with local examples, local language, and local community integration.
---
## 🎯 Features
- **5 Learning Modules** covering Bitcoin basics, Lightning Network, self-custody, transactions, and savings
- **15 Lessons** with rich educational content in **English, Bemba (Icibemba) and Nyanja (Chinyanja)**
- **Quiz system** with instant feedback and explanation for each answer
- **XP + Level progression** (10 levels, from Satoshi Seedling to Zambian Bitcoin Legend)
- **Sats rewards** for completing quizzes (simulated — real Lightning integration ready)
- **Streak tracking** — daily learning rewards
- **Leaderboard** with community rankings
- **PWA** — installable on Android, works offline (partial)
- **No account required** — all progress stored locally
- **Zero cost** to use
---
## 🏗️ Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Next.js 14 (App Router), TypeScript |
| Styling | Tailwind CSS + custom CSS animations |
| State Management | Zustand with localStorage persistence |
| Fonts | Syne (display) + Space Grotesk (body) |
| Lightning (future) | BTCPay Server / OpenNode API |
| Deployment | Vercel (recommended) |
---
## 🚀 Getting Started
### Prerequisites
- Node.js 18+
- npm or yarn
### Installation
```bash
# Clone the repo
git clone github.com
cd satoshi-quest-zambia
# Install dependencies
npm install
# Start development server
npm run dev
```
Open localhost
### Production Build
```bash
npm run build
npm start
```
### Deploy to Vercel
```bash
npm install -g vercel
vercel --prod
```
---
## 📚 Module Overview
| # | Module | Language | Lessons | Sats Reward |
|---|---|---|---|---|
| 1 | What is Bitcoin? (Bitcoin Ns …