KarmaCircle (product name "Milan") is a hub to connect NGOs, Charities, and the world to collaborate and build a better tomorrow. Sign up as an organization/user and be a cause for change. Don't forget to drop a star ⭐.
This repo holds both apps that make up KarmaCircle:
| App | Path | What it is |
|---|---|---|
| Frontend | apps/web |
milan-frontend — React 19 + Vite SPA |
| Backend | apps/api |
milan-api — Express + TypeScript + MongoDB API |
They're independently deployed (two separate Vercel projects) but share this repo, CI, and contribution workflow. See CLAUDE.md and AGENTS.md for the fuller architecture/agentic-workflow notes, and each app's own docs/specs/README.md for its feature/module map.
Remember, Good PR makes you a Good contributor!
We at KarmaCircle work hard to maintain the structure, and use conventional Pull request titles and commits. Without a proper template for the PR, not following the guidelines and spam might get the pull request closed, or banned.
- Forking + Cloning Guide
- Setting up the Frontend
- Setting up the Backend
- Setting up with docker
- Full local dev setup (frontend + backend + MongoDB in one go) — the fastest path if you just want everything running
- Contributing Guidelines to be followed.
- Proper API documentation for developers.
KarmaCircle is Licensed under the MIT License. Please go through the License at least once before contributing.
Don't forget to drop a star ⭐. A heartfelt thank you to those who have contributed to this project. We are really grateful for your contribution. You all are amazing. Opensource for the win 🚀