Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oliviertassinari/splitme
Split expenses with friends.
https://github.com/oliviertassinari/splitme
bills dividing expenses friends roommates sharing splitting
Last synced: 16 days ago
JSON representation
Split expenses with friends.
- Host: GitHub
- URL: https://github.com/oliviertassinari/splitme
- Owner: oliviertassinari
- License: mit
- Created: 2015-02-21T11:41:47.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-04-11T17:47:58.000Z (over 1 year ago)
- Last Synced: 2024-10-12T23:13:55.477Z (about 1 month ago)
- Topics: bills, dividing, expenses, friends, roommates, sharing, splitting
- Language: JavaScript
- Homepage: https://splitme.net
- Size: 53.6 MB
- Stars: 154
- Watchers: 9
- Forks: 33
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SplitMe
[](https://circleci.com/gh/oliviertassinari/SplitMe/tree/master)
> Split expenses with friends
## The app
### Description
Use SplitMe to share group bills and make sure that everyone gets paid back.
Split household bills with roommates, figure out costs for a group trip, remember when a friend spots you for lunch.
**Features**
- Multiple groups
- Multiple currencies
- Expenses log
- Minimal number of transactions to settle debts within a group
- Export/Import data
- No ads
### Screenshots
## The technology stack
To achieve [high performance](https://www.webpagetest.org/result/170322_SP_1BPQ/1/details/) and flexibility, we use the following elements:
- React
- Service worker
- Server side rendering
- Code splitting
- Inlining of the critical CSS thanks to CSS-in-JS
- Cordova iOS & Android
- A CDN
## Install
```sh
npm install -g pouchdb-server
npm install
cd cordova
../node_modules/.bin/cordova prepare
```
### Test
```sh
npm install selenium-standalone -g
selenium-standalone install
```
### Android
```sh
brew install android-sdk
```
### iOS
```sh
brew install graphicsmagick
npm run cordova:icons
npm run cordova:imagemin
```
## Development
```sh
npm start
pouchdb-server
```
## Environement
### Production
- Browser [splitme.net](https://splitme.net)
- Android [Google Play](https://play.google.com/store/apps/details?id=com.split.app)
- iOS [Apple Store](https://itunes.apple.com/gb/app/splitme-friends-expenses/id1130782526?mt=8)
### Staging
- Browser [staging.splitme.net](https://staging.splitme.net)
## Screenshot
### Android
```sh
adb shell screencap -p | perl -pe 's/\x0D\x0A/\x0A/g' > screen.png
```
### iOS
`cmd` + `s`
## Redux
### Action name
Use the [FSA](https://github.com/acdlite/flux-standard-action) standard.
use action name linked to the action triggered by the user. The action name shouldn't be link to the mutation of the store needed.
Exception, the action is used in only one reducer and the mutation is duplicated by other action in this same reducer. Then the action name can be linked to the store mutation
## Release process
### iOS
1. Update the *package.json* version.
1. Build the app
1. You may encounter this error *No matching provisioning profile found*. Ask your team for it. You need the provisioning profile and the associated signin key.
1. Go into Xcode build for the *Generic iOS Device*.
1. *Product* > *Archive*.
1. *Upload to App Store*
1. Make sure you have been invited in the *SplitMe* organization.
1. Make sure you are an *App Manager* with your iTunes Connect account.
## Contributing
Changes and improvements are more than welcome!
Feel free to fork and open a pull request.
Please make your changes in a specific branch and request to pull into master!