A robust and privacy-centric mobile application designed to empower users with full control over their personal finances. Built with TypeScript and React Native, this project focuses on local-first data integrity, automated recurring transaction management, and high-level security.

Budget Tracker is more than just a ledger; it is a financial companion that helps users plan future purchases, monitor spending trends, and stay within their means through intelligent budget threshold alerts. By leveraging SQLite for local storage, all sensitive financial data remains strictly on the device, ensuring maximum privacy.

• Transaction Lifecycle Management: Seamlessly add, delete, and categorize income and expenses.
• Recurring Automation: Intelligent logic to automatically handle monthly income and expenses based on user-defined dates.
• Planned Purchases & Reminders: A dedicated system to track future acquisitions with swipe-to-buy functionality that automatically converts plans into expense entries.
• Security Suite: Dual-layer protection featuring biometric authentication (FaceID/Fingerprint) and a secure 4-digit passcode fallback.
• Visual Analytics: Real-time spending trend graphs to help identify financial patterns over weekly, monthly, or all-time scales.
• Smart Notifications: Automated alerts for recurring transaction due dates and budget threshold warnings.

• Node.js (LTS version recommended)
• npm or yarn
• Expo Go app on your mobile device or an emulator (Android Studio / Xcode)

1. Clone the Repository:

   git clone https://github.com/KingSlayer-double07/budget_tracker.git
   cd budget_tracker

2. Install Dependencies:

   npm install

3. Start the Development Server:

   npx expo start

4. Launch the App:

   • Scan the QR code with your phone (using Expo Go).
   • Press a for Android emulator or i for iOS simulator.

The main screen provides a high-level summary of your financial health, displaying Total Income, Total Expenses, and your current Net Balance. From here, you can quickly navigate to specific management modules.

• Income/Expenses: Enter the source/item name and amount. Toggle the "Recurring" switch to set a specific day of the month for automated logging.
• Planned Purchases: Track items you intend to buy. When you finally make the purchase, swipe the item in the list to "Mark as Bought," which automatically logs it as an expense and updates your balance.

Navigate to the Settings gear on the dashboard to:

• Enable/Disable Biometric Security.
• Configure a 4-digit Passcode.
• Set a Budget Threshold. The app will notify you once your total monthly expenses reach this specified limit.

Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

• Fork the Project.
• Create your Feature Branch (git checkout -b feature/AmazingFeature).
• Commit your Changes (git commit -m 'Add some AmazingFeature').
• Push to the Branch (git push origin feature/AmazingFeature).
• Open a Pull Request.

[Favour Akande/KingSlayer] Software Engineer & Mobile App Developer

• GitHub: KingSlayer-double07
• LinkedIn: favourakande
• Twitter/X: favourdslayer
• Email: favourakande1@gmail.com