An open-source, self-hostable helpdesk and ticketing platform built with Next.js, Supabase, and Shadcn UI β built for teams in Africa and beyond.
# π§ WetinHapin β Open Helpdesk Platform
**WetinHapin** is an open-source, fully featured helpdesk platform designed for organizations, institutions, and companies across Africa and beyond. It allows teams to handle internal or external support requests, track ticket lifecycles, collaborate across departments, and customize workflows.
> π§ Self-hostable Β· πͺ Built with modern tools Β· π¬ Designed for real-world teams Β· πΈπ± Made for Africa
---
## π§± Monorepo Structure
This project is built using Turborepo and follows a modern mono-repo architecture.
```bash
wetinhapin/
βββ apps/
β βββ wetinhapin-helpdesk/ # Main helpdesk dashboard (admin, agents, supervisors)
β βββ wetinhapin-customer-portal/ # Public customer portal (create ticket, view status, self-help)
β βββ wetinhapin-docs-site/ # Static documentation site for deployment + setup
β
βββ packages/
β βββ ui/ # Shared Shadcn UI components, Tailwind config
β βββ eslint-config/ # ESLint config
| |-- typescript-config/ # TSConfig base files and config
β βββ db-schema/ # Supabase schema + RLS + seed scripts
β βββ utils/ # Shared validation, helper functions, email templates
```
## π§° Tech Stack
- **Frontend:** Next.js App Router Β· Tailwind CSS Β· Shadcn UI Β· Framer Motion, more...(check the package.json file)
- **Backend:** Supabase (Postgres, Auth, Realtime, Storage)
- **Testing:** Jest Β· Playwright
- **CI/CD:** GitHub Actions (planned)
- **Infrastructure:** Docker (optional), Render (for backend), Vercel (for frontend)
- **Email:** Resend Β· React Email
- **Other:** Zod Β· TypeScript Β· Turborepo, and more...
## π License
This software is licensed under the **AGPL-3.0 License**.
You are free to self-host and modify, but **commercial SaaS use (hosting for others)** is **not permitted** under this license.
## π Contributing
Community contributions are welcome!
Please see the `CONTRIBUTING.md` file for:
- Development setup
- Code style guidelines
- P β¦