A platform to help betting addicts in Malawi through structured recovery programs, expert counselling, and community support.
# Betting Addiction Support Malawi (BASM)
A digital platform helping betting addicts in Malawi through structured recovery programs, professional counselling, and peer community support.
## π― Mission
To provide accessible, stigma-free support for individuals struggling with betting addiction in Malawi.
## π Features
- **Self-Assessment Quiz** β gauge addiction severity and get matched to the right program
- **Recovery Programs** β 3 tiers (30/60/90 day) with structured daily activities
- **Expert Counselling** β book one-on-one sessions with certified counsellors
- **Group Therapy** β anonymous peer support sessions
- **Crisis SOS** β immediate help when relapse risk is high
- **Progress Tracking** β milestones, badges, and accountability tools
- **Resource Library** β articles, videos, and self-help tools
## ποΈ Project Structure
```
betting-addiction-support-malawi/
βββ frontend/ # React.js frontend
β βββ src/
β βββ components/ # Reusable UI components
β βββ pages/ # App pages/screens
β βββ hooks/ # Custom React hooks
β βββ utils/ # Helper functions
βββ backend/ # Node.js + Express API
β βββ src/
β βββ routes/ # API route definitions
β βββ controllers/ # Business logic
β βββ models/ # Database models
β βββ middleware/ # Auth, logging, etc.
βββ docs/ # Project documentation
```
## π οΈ Tech Stack
- **Frontend:** React.js, TailwindCSS
- **Backend:** Node.js, Express.js
- **Database:** PostgreSQL
- **Auth:** JWT
## π Getting Started
### Prerequisites
- Node.js v18+
- PostgreSQL 14+
### Installation
```bash
# Clone the repo
git clone
github.com
cd betting-addiction-support-malawi
# Install backend dependencies
cd backend && npm install
# Install frontend dependencies
cd ../frontend && npm install
```
### Running Locally
```bash
# Backend (from /backend)
npm run dev
# Frontend (from / β¦