Skip to content

oss-apps/split-pro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SplitPro Logo

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 Splitwise. My main problem is how they implemented this.

Monetising on pro features or 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

FAQ

How numerically stable is the internal logic?

All numbers are stored in the DB as BigInt data, with no floats what so ever, safeguarding your expences from rounding errors or lack of precision. This holds true for currencies with large nominal values that might outgrow the safe range of JS number type.

How are leftover pennies handled?

In case of an expense that cannot be split evenly, the leftover amounts are distributed randomly across participants. The assignment is as equal as possible, in the context of a single expense (similar to Splitwise).

Tech stack

Getting started.

Prerequisites

  • Node.js (Version: >=22.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.

Developer Setup

Install Dependencies

corepack enable
pnpm i

Setting up the environment

Run the app

pnpm d

Sponsors

We are grateful for the support of our sponsors.

Our Sponsors

hekuta

Star History

Star History Chart