Billy <!-- omit in toc -->

<div align="center"> <img width="200" src="./assets/BillyHero.png"></img> </div> <div align="center"> <a href="https://github.com/lyqht/Billy/actions/workflows/update-types.yml"><img width="200" src="https://github.com/lyqht/Billy/actions/workflows/update-types.yml/badge.svg"></img></a> </div> <div align="center"> <a href="https://play.google.com/store/apps/details?id=com.lyqht.billy">Beta Track release on Google Play ▶️</a> </div> <div align="center"> <p> <a href="#introduction-">Introduction 🌱</a> • <a href="./CONTRIBUTING.md">Contributing ✨</a> • <a href="#tech-notes-">Tech Notes 🗒</a> </p> </div>

Introduction 🌱

Billy is your mobile companion app to help you manage your upcoming bills and remind you when they're due. Say goodbye to late payment fees!

<div align="center"> <img src="./docs/static/img/billy_features.png" alt="Add expenses and reminders at the New Bill Screen, Track your Bills at the Home Page/Upcoming Bills Screen, and Bar chart analytics of your expenses by month."></img> </div> <br />

• If you are keen on how the app idea came about, you can refer to the section on how it started.
• For more in-depth details on planned & implemented features, you could refer to ROADMAP.md.
• Previous progress on this project can be tracked via the main dev's tweets. Note that this project is no longer updated.

Tech Notes 🗒

Building blocks of this project 🧱

• UI Kittens for UI components
• Supabase for Database & Auth. Data is served by REST.
• React Native MMKV for caching
• Notifee for creating notifications
• Victory for creating charts
• Custom GitHub action for generating Supabase database types
• Custom Web Scraper for getting Singapore Billing Organisations for populating payee options

If you are interested on other aspects of how this app is built (e.g. how the app is bootstrapped, tech architecture, mockup etc), check out Billy's documentation.

Contributing

Please refer to CONTRIBUTING.md for contribution guidelines and setup instructions.