|
| 1 | +<div align="center"> |
| 2 | + <img src="./assets/icon.png" width="150" height="150"> |
| 3 | +</div> |
| 4 | +<br> |
| 5 | +<h1 align="center"> |
| 6 | + EZ Split - Expenses Made Easy |
| 7 | +</h1> |
| 8 | + |
| 9 | +<p align="center"> |
| 10 | + <a href="https://docs.expo.dev/get-started/installation/"> |
| 11 | + <img alt="Expo Dev" src="https://img.shields.io/badge/expo-v47-blue"> |
| 12 | + </a> |
| 13 | + <a href="https://reactnative.dev/docs/getting-started/"> |
| 14 | + <img alt="React Native" src="https://img.shields.io/badge/react--native-v0.70.5-blue"> |
| 15 | + </a> |
| 16 | + <a href="https://reactnativeelements.com/docs/"> |
| 17 | + <img alt="React Native Elements" src="https://img.shields.io/badge/react--native--elements-v4-blue"> |
| 18 | + </a> |
| 19 | + <a href="https://play.google.com/store/apps/details?id=com.ibizabroker.EZSplit"> |
| 20 | + <img src="https://img.shields.io/badge/android-5.0%2B-green"> |
| 21 | + </a> |
| 22 | +</p> |
| 23 | + |
| 24 | +<p align="center"> |
| 25 | + <a href="#overview">Overview</a> |
| 26 | + • |
| 27 | + <a href="#app-design">App Design</a> |
| 28 | + • |
| 29 | + <a href="#installation">Installation</a> |
| 30 | + • |
| 31 | + <a href="#run-command">Run Command</a> |
| 32 | +</p> |
| 33 | + |
| 34 | +# Overview |
| 35 | + |
| 36 | +EZ Split is the ultimate solution for those seeking an effortless and convenient way to split expenses with friends and family. Say goodbye to the hassle of logging in or navigating through complicated sign-up processes. Our app is designed to be quick and straightforward, allowing you to focus on what's most important – splitting expenses. |
| 37 | + |
| 38 | +With our unique feature of exporting an image of all balances in a group, sharing expenses has never been easier. Simply share the image through any messaging or social media platform. For a more detailed report, our app can generate an expense report in the form of an Excel spreadsheet, making it simple to keep track of all your expenses. |
| 39 | + |
| 40 | +EZ Split is super versatile, allowing you to create groups with any currency from across the world. Say goodbye to the frustration of having to manually convert expenses; we've got you covered. Whether you're traveling abroad or splitting expenses with friends from different countries, EZ Split makes it effortless. |
| 41 | + |
| 42 | +Don't wait, download <a href="https://play.google.com/store/apps/details?id=com.ibizabroker.EZSplit">EZ Split</a> today and start splitting expenses in the easiest way possible! |
| 43 | + |
| 44 | +# App Design |
| 45 | +<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FLGlAFz7qoakgYMqS7qpapc%2FEZ-Split%3Fnode-id%3D0%253A1%26t%3DeoH04vI3ktDupdcm-1" allowfullscreen></iframe> |
| 46 | + |
| 47 | +# Installation |
| 48 | +The recommended expo-cli version for this app is 6+. |
| 49 | +``` |
| 50 | +npm install |
| 51 | +``` |
| 52 | + |
| 53 | +# Run Command |
| 54 | +To test the dev version of the app: |
| 55 | +``` |
| 56 | +npx expo start |
| 57 | +``` |
| 58 | + |
| 59 | +To check if the app is working in production, change the [eas.json](./eas.json) configuration to: |
| 60 | +``` |
| 61 | +{ |
| 62 | + "build": { |
| 63 | + "preview": { |
| 64 | + "android": { |
| 65 | + "buildType": "apk" |
| 66 | + } |
| 67 | + }, |
| 68 | + "preview2": { |
| 69 | + "android": { |
| 70 | + "gradleCommand": ":app:assembleRelease" |
| 71 | + } |
| 72 | + }, |
| 73 | + "preview3": { |
| 74 | + "developmentClient": true |
| 75 | + }, |
| 76 | + "production": {} |
| 77 | + } |
| 78 | +} |
| 79 | +``` |
| 80 | +Create a build file to test the app on emulator: |
| 81 | +``` |
| 82 | +eas build -p android --profile emulatorBuild |
| 83 | +``` |
| 84 | +This will generate an apk file. You can install it on the emulator via command prompt or you can drag and drop the apk file onto the emulator. |
0 commit comments