An open-source expense splitting and settlement tracking application. Split bills fairly, track shared expenses, and settle up with friends.
Disclaimer This is a vibe-coded application used to test and experiment with vibe coding and AI-assisted coding workflows. Code quality may vary and the project should be treated as an experimental work.
FairShare helps groups of friends, roommates, or colleagues manage shared expenses effortlessly. Whether you're splitting a dinner bill, tracking rent and utilities, or managing group trips, FairShare makes it easy to see who owes what and settle up.
Start all services:
docker compose up --buildServices:
| Service | URL |
|---|---|
| Web (React) | http://localhost:5173 |
| API (FastAPI) | http://localhost:8001 |
| API Docs | http://localhost:8001/docs |
| pgAdmin | http://localhost:8081 |
For package-specific details, see web/README.md and api/README.md.
See LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.
When contributing:
- Follow the existing code patterns
- Write tests for new functionality
- Update documentation as needed
- Ensure code passes linting