{"id":28907732,"url":"https://github.com/awais-124/khata_tracker","last_synced_at":"2026-05-10T05:09:11.144Z","repository":{"id":299935358,"uuid":"1004666763","full_name":"awais-124/khata_tracker","owner":"awais-124","description":"A Flutter app for managing your debts and be reminded to pay in time. ","archived":false,"fork":false,"pushed_at":"2025-06-19T02:53:46.000Z","size":2032,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-19T03:19:30.423Z","etag":null,"topics":["coding","dart","development","firebase","flutter","fullstack","khata","mobile-app"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/awais-124.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-06-19T02:00:49.000Z","updated_at":"2025-06-19T02:53:49.000Z","dependencies_parsed_at":"2025-06-25T07:34:04.991Z","dependency_job_id":null,"html_url":"https://github.com/awais-124/khata_tracker","commit_stats":null,"previous_names":["awais-124/khata_tracker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/awais-124/khata_tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awais-124%2Fkhata_tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awais-124%2Fkhata_tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awais-124%2Fkhata_tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awais-124%2Fkhata_tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awais-124","download_url":"https://codeload.github.com/awais-124/khata_tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awais-124%2Fkhata_tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271121168,"owners_count":24702723,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-19T02:00:09.176Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["coding","dart","development","firebase","flutter","fullstack","khata","mobile-app"],"created_at":"2025-06-21T16:05:37.168Z","updated_at":"2026-05-10T05:09:11.110Z","avatar_url":"https://github.com/awais-124.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Khata Tracker 💰\n\n[![Flutter](https://img.shields.io/badge/Flutter-3.16-blue)](https://flutter.dev)\n[![Firebase](https://img.shields.io/badge/Firebase-11.0-orange)](https://firebase.google.com)\n[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)\n\nA cross-platform debt management app built with Flutter \u0026 Firebase. Track loans, credit, and payments seamlessly across Android, iOS, and Web.\n\n## Features ✨\n\n* 🔐 Secure authentication (Email/Google)\n* 📝 Record debts with details (amount, date, witness)\n* 🔍 Search \u0026 filter by person/status\n* 📊 Monthly debt summaries\n* 🎨 Dark/Light theme support\n* 📄 Export transactions to PDF\n* 🔔 Payment reminders\n\n## Tech Stack 🖪️\n\n* **Frontend**: Flutter 3.16\n* **Backend**: Firebase (Auth, Firestore)\n* **State Management**: Provider\n* **PDF Generation**: `pdf` package\n* **Notifications**: `flutter_local_notifications`\n\n## Screenshots 📱\n\n| Login Screen                                         | Debt List                                            | Add Transaction                                         |\n| ---------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------- |\n| \u003cimg src=\"assets/screenshots/login.png\" width=\"200\"\u003e | \u003cimg src=\"assets/screenshots/debts.png\" width=\"200\"\u003e | \u003cimg src=\"assets/screenshots/add_debt.png\" width=\"200\"\u003e |\n\n## Installation 🚀\n\n### Prerequisites\n\n* Flutter SDK (\u003e=3.16.0)\n* Firebase account\n* Android Studio/Xcode (for mobile builds)\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/awais-124/khata_tracker.git\ncd khata_tracker\n```\n\n### 2. Firebase Setup\n\nCreate a new Firebase project at [console.firebase.google.com](https://console.firebase.google.com)\n\nEnable these services:\n\n* **Authentication** (Email/Password + Google)\n* **Firestore Database** (Start in test mode)\n\n### 3. Configure FlutterFire\n\n```bash\n# Install FlutterFire CLI\ndart pub global activate flutterfire_cli\n\n# Run configuration (select platforms: Android, iOS, Web)\nflutterfire configure\n```\n\n### 4. Install Dependencies\n\n```bash\nflutter pub get\n```\n\n### 5. Running the App ▶️\n\n**Web Development**\n\n```bash\nflutter run -d chrome\n```\n\n**Android Build**\n\n```bash\nflutter build apk --release\n# APK location: build/app/outputs/flutter-apk/app-release.apk\n```\n\n**iOS Build (Mac Only)**\n\n```bash\nflutter build ios\nopen ios/Runner.xcworkspace\n```\n\n## Project Structure 📂\n\n```\nlib/\n├── core/               # Business logic \u0026 utilities\n│   ├── constants/      # App constants\n│   ├── services/       # Firebase services\n│   └── utils/          # Helper functions\n├── features/           # Feature modules\n│   ├── auth/           # Authentication\n│   ├── debts/          # Debt management\n│   └── settings/       # User settings\n├── shared/             # Reusable components\n│   ├── models/         # Data models\n│   └── widgets/        # Custom widgets\n└── main.dart           # App entry point\n```\n\n## Environment Variables 🔒\n\nCreate `.env` file in root (add to `.gitignore`):\n\n```env\nFIREBASE_API_KEY=your_api_key\nFIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com\nFIREBASE_PROJECT_ID=your_project_id\n```\n\n## Common Issues \u0026 Fixes ⚠️\n\n### 1. Firebase Not Initialized\n\n```bash\n# Ensure you've run:\nflutterfire configure\n```\n\n### 2. Web CORS Errors\n\nUpdate Firestore rules (for dev only):\n\n```js\nrules_version = '2';\nservice cloud.firestore {\n  match /databases/{database}/documents {\n    match /{document=**} {\n      allow read, write: if true;\n    }\n  }\n}\n```\n\n## Contributing 🤝\n\n1. Fork the repository\n2. Create a new branch\n\n```bash\ngit checkout -b feature/your-feature\n```\n\n3. Commit your changes\n\n```bash\ngit commit -m \"Add some feature\"\n```\n\n4. Push to the branch\n\n```bash\ngit push origin feature/your-feature\n```\n\n5. Open a Pull Request\n\n## License 📄\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Need Help?\n\nContact [@awais-124](https://github.com/awais-124) or open an issue in the repository.\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawais-124%2Fkhata_tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawais-124%2Fkhata_tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawais-124%2Fkhata_tracker/lists"}