ossapps/splitpro repository overview

⁠

⁠SplitPro

⁠An open source alternative to Splitwise

To our App »⁠

⁠About

SplitPro aims to provide an open-source way to share expenses with your friends.

It's meant to be a complete replacement for Splitwise.

It currently has most of the important features.

• Add expenses with an individual or groups
• Overall balances across the groups
• Multiple currency support
• Upload expense bills
• PWA support
• Split expense unequally (share, percentage, exact amounts, adjustments)
• Push notification
• Download your data
• Import from splitwise

More features coming every day

---

⁠Why

Splitwise is one of the best apps to add expenses and bills.

I understand that every app needs to make money, After all, lots of effort has been put into Spliwise. My main problem is how they implemented this.

Making pro features or asking money to remove ads is fine, But asking money for adding Expenses (Core feature) is frustrating.

I was searching for other open-source alternatives (Let's be honest, any closed-source product might do the same and I don't have any reason to believe otherwise).

I managed to find a good app spliit.app⁠ by Sebastien Castiel⁠ but it's not a complete replacement and didn't suit my workflow sadly. Check it out to see if it fits you.

That's when I decided to work on this

⁠Tech stack

• NextJS⁠
• Tailwind⁠
• tRPC⁠
• ShadcnUI⁠
• Prisma⁠
• Postgres⁠
• NextAuth⁠

⁠Getting started.

⁠Prerequisites

• Node.js (Version: >=18.x)
• PostgreSQL
• pnpm (recommended)

⁠Docker

We provide a Docker container for Splitpro, which is published on both DockerHub and GitHub Container Registry.

DockerHub: https://hub.docker.com/r/ossapps/splitpro⁠

GitHub Container Registry: https://ghcr.io/oss-apps/splitpro⁠

You can pull the Docker image from either of these registries and run it with your preferred container hosting provider.

Please note that you will need to provide environment variables for connecting to the database, redis, aws and so forth.

For detailed instructions on how to configure and run the Docker container, please refer to the Docker Docker README⁠ in the docker directory.

⁠Run locally

• Copy .env.example to .env to the root directory and add the required env variables.
• R2 related env is for cloudflare R2 used to upload and can be set up here⁠
• RESEND env could be obtained by creating a free account on here⁠
• Run pnpm install
• Run pnpm db:push or pnpm prisma:prod to populate db migrations
• Run pnpm dev