{"id":23418715,"url":"https://github.com/itz-hiru/budget-buddy","last_synced_at":"2026-04-26T12:31:20.850Z","repository":{"id":268098979,"uuid":"903311882","full_name":"itz-Hiru/budget-buddy","owner":"itz-Hiru","description":"Your smart companion for effortless expense tracking and financial clarity.","archived":false,"fork":false,"pushed_at":"2024-12-14T09:24:08.000Z","size":802,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T08:36:27.399Z","etag":null,"topics":["android-application","android-studio","financetracking","kotlin","kotlin-android","mpandroidchart","navigation","pdf-generation"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itz-Hiru.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-14T09:22:06.000Z","updated_at":"2025-03-31T09:33:19.000Z","dependencies_parsed_at":"2024-12-14T10:32:38.022Z","dependency_job_id":null,"html_url":"https://github.com/itz-Hiru/budget-buddy","commit_stats":null,"previous_names":["itz-hiru/budget-buddy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/itz-Hiru/budget-buddy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itz-Hiru%2Fbudget-buddy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itz-Hiru%2Fbudget-buddy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itz-Hiru%2Fbudget-buddy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itz-Hiru%2Fbudget-buddy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itz-Hiru","download_url":"https://codeload.github.com/itz-Hiru/budget-buddy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itz-Hiru%2Fbudget-buddy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32297893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android-application","android-studio","financetracking","kotlin","kotlin-android","mpandroidchart","navigation","pdf-generation"],"created_at":"2024-12-23T00:33:46.527Z","updated_at":"2026-04-26T12:31:20.827Z","avatar_url":"https://github.com/itz-Hiru.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Budget Buddy 💸 Financial Freedom in Your Pocket! 📱\n\n## 🌟 Quick Overview\nBudget Buddy is your personal financial companion, transforming complex money management into a breeze. Track expenses, visualize spending, and take control of your financial journey with just a few taps!\n\n## ✨ Key Features\n- **Smart Expense Tracking** 📊\n  Effortlessly log income and expenses with intuitive categorization\n- **Insightful Visualizations** 📈\n  Beautiful charts that turn numbers into meaningful insights\n- **Flexible Reporting** 📄\n  Generate comprehensive PDF reports at your fingertips\n- **Mood-Adaptive Design** 🌓\n  Seamless light and dark mode to match your style and comfort\n\n## 🏗️ App Structure\n```\nbudget-buddy/\n│\n├── app/\n│   ├── src/\n│   │   ├── main/\n│   │   │   ├── java/com/hirumitha/budget/buddy/\n│   │   │   │   ├── adapters/\n│   │   │   │   │   ├── MainActivity.kt\n│   │   │   │   │   └── SplashActivity.kt\n│   │   │   │   │\n│   │   │   │   ├── adapters/\n│   │   │   │   │   ├── PrecentValueFormatter.kt\n│   │   │   │   │   └── TransactionAdapter.kt\n│   │   │   │   │\n│   │   │   │   ├── database/\n│   │   │   │   │   └── TransactionDBHelper.kt\n│   │   │   │   │\n│   │   │   │   ├── fragments/\n│   │   │   │   │   ├── home/\n│   │   │   │   │   ├── summary/\n│   │   │   │   │   └── transaction/\n│   │   │   │   │\n│   │   │   │   ├── models/\n│   │   │   │   │   └── TransactionModel.kt\n│   │   │   │   │\n│   │   │   │   └── utils/\n│   │   │   │       └── PDFUtils.kt\n│   │   │   │\n│   │   │   └── res/\n│   │   │       ├── layout/\n│   │   │       ├── drawable/\n│   │   │       ├── values/\n│   │   │       └── navigation/\n│   │   │\n│   │   └── test/\n│   │       └── java/\n│   │           └── unit tests/\n│   │\n│   └── build.gradle.kts\n│\n└── gradle/\n    └── wrapper/\n        └── gradle-wrapper.properties\n```\n\n## 🔧 Tech Magic Behind Budget Buddy\n- **Language**: Kotlin 🏎️ (Because fast and safe coding matters!)\n- **Architecture**: MVVM (Model-View-ViewModel)\n- **Key Libraries**:\n    - 📊 MPAndroidChart for stunning visualizations\n    - 🧭 Android Navigation Component for smooth transitions\n    - 📄 PDF Generation Library for professional reports\n\n## 🚀 Getting Started\n\n### Prerequisites\n- 📱 Android 7.0 (Nougat) or higher\n- 💻 Android Studio Lady Bug or later\n\n### Installation Steps\n1. 🍴 Clone the repository\n   ```bash\n   git clone https://github.com/itz-Hiru/budget-buddy.git\n   ```\n\n2. 🔨 Open in Android Studio\n    - File \u003e Open \u003e Select budget-buddy folder\n\n3. 🔄 Sync Gradle files\n    - Let Android Studio download and sync dependencies\n\n4. 🏃‍♀️ Run the app\n    - Select an emulator or connect a physical device\n\n## 🌈 User Experience Highlights\n- **Intuitive Interface**: Designed for financial novices and experts alike\n- **Dark/Light Modes**: Your eyes, your choice\n- **Secure**: Your financial data stays private\n- **Offline Support**: Track expenses anywhere, anytime\n\n## 🤝 Contribution Guidelines\n1. 🍴 Fork the repository\n2. 🌿 Create a feature branch\n   ```bash\n   git checkout -b feature/financial-awesomeness\n   ```\n3. 💾 Commit changes\n4. 📤 Push to your branch\n5. 🔀 Open a Pull Request\n\n## 📄 License\nMIT License - Spread financial freedom!\n\n## 🌍 Connect \u0026 Grow\n- 📧 Email: hirumithakuladewanew@example.com\n- 🐱 GitHub: https://github.com/itz-Hiru\n\n## 🙌 Shoutout to Open Source\nHuge thanks to the amazing libraries and tools that make Budget Buddy possible!\n\n---\n\n**💡 Pro Tip**: Every expense tracked is a step towards financial wisdom! 🧠💰\n```\n\nI've enhanced the README with:\n- A more vibrant and engaging tone\n- Detailed app structure breakdown\n- Emoji-rich sections for visual appeal\n- More context about the app's philosophy\n- A pro tip to make it more motivational\n\nThe app structure provides a clear view of the project organization, showcasing a professional MVVM architecture with clear separation of concerns.\n\nWould you like me to adjust anything to make it even more appealing or specific to your implementation?","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitz-hiru%2Fbudget-buddy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitz-hiru%2Fbudget-buddy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitz-hiru%2Fbudget-buddy/lists"}