A full‑stack expense splitting and group settlement platform.
📚 Explore the Docs »
🎬 Demo Video
·
🐛 Report Bug
·
✨ Request Feature
📑 Table of Contents
Cayeshni is a secure full-stack platform for splitting expenses, managing group balances, and settling shared payments.
Core capabilities:
- Authentication and identity management
- Group creation and invite-based membership
- Transactions, balances, and settlements
- Friend management and notifications
- File uploads with cloud storage
Backend
Frontend
DevOps & Infrastructure
Deployment
| Service | URL |
|---|---|
| 🖥️ Frontend | cayeshni-app.vercel.app |
| ⚙️ Backend API | cayeshni-production.up.railway.app |
| 🏥 Health Check | /health |
Demo video coming soon.
Screenshots coming soon.
- .NET SDK (net10.0)
- Node.js 20+
- Docker Desktop (recommended)
- PostgreSQL (if running backend without Docker)
1. Environment configuration
Create a .env file at the repository root. Copy .env.example and update secrets and connection settings.
2. Run with Docker (recommended)
docker compose up --buildThe stack exposes:
| Service | URL |
|---|---|
| API | http://localhost:8080 |
| Web | http://localhost:3000 |
| PostgreSQL | localhost:5432 |
3. Run locally (without Docker)
Backend:
cd backend
dotnet restore
dotnet run --project Cayeshni.APIFrontend:
cd frontend
npm install
npm run devHelper scripts are available in the backend/ folder:
# PowerShell
./create-migration.ps1
# Bash
./create-migration.shWhen running in Development mode, the API exposes:
| Interface | URL |
|---|---|
| OpenAPI JSON | http://localhost:8080/openapi/v1.json |
| Scalar UI | http://localhost:8080/scalar/v1 |
| Swagger UI | http://localhost:8080/swagger |
Detailed documentation for each feature lives in docs/features/:
| Feature | Description |
|---|---|
| 🔐 Authentication & Identity | Secure login, registration, and token management |
| 👤 User Management | Profile management and settings |
| 👥 Groups | Create groups, invite members, manage membership |
| 🤝 Friends | Send and manage friend connections |
| 💸 Transactions | Add, split, and track shared expenses |
| 🏦 Settlements | Calculate and settle balances between members |
| 📊 Dashboard | Overview of balances, activity, and summaries |
- Core authentication and identity management
- Group and transaction management
- Settlement calculations and automation
- Cloud file storage with Cloudinary
- Containerized deployment with Docker
- CI/CD with GitHub Actions and Semantic Release
- Mobile app support
- Real-time notifications
- Advanced analytics and reporting
- Multi-currency support
See the open issues for a full list of planned features and known bugs.
Contributions, issues, and feature requests are welcome!
Check the issues page to get started, or read the full contributing guide.
If this project helped you, please give it a star! It helps us reach more people.
This project is still under active development. License terms have not been finalized yet.