{"id":29308538,"url":"https://github.com/kodiererin/expensemate","last_synced_at":"2026-04-14T15:32:00.198Z","repository":{"id":303071808,"uuid":"1012087437","full_name":"Kodiererin/ExpenseMate","owner":"Kodiererin","description":"This app was build for personal usage, to maintain and keep track of the expenses.","archived":false,"fork":false,"pushed_at":"2025-07-05T13:36:46.000Z","size":723,"stargazers_count":1,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-05T14:41:38.114Z","etag":null,"topics":["android","android-app","android-application","android-studio","expo","ios-app","react-native"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Kodiererin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2025-07-01T19:43:07.000Z","updated_at":"2025-07-05T13:38:26.000Z","dependencies_parsed_at":"2025-07-05T14:53:20.116Z","dependency_job_id":null,"html_url":"https://github.com/Kodiererin/ExpenseMate","commit_stats":null,"previous_names":["kodiererin/expensemate"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Kodiererin/ExpenseMate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kodiererin%2FExpenseMate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kodiererin%2FExpenseMate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kodiererin%2FExpenseMate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kodiererin%2FExpenseMate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kodiererin","download_url":"https://codeload.github.com/Kodiererin/ExpenseMate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kodiererin%2FExpenseMate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264032310,"owners_count":23546809,"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","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","android-app","android-application","android-studio","expo","ios-app","react-native"],"created_at":"2025-07-07T07:12:33.741Z","updated_at":"2026-04-14T15:32:00.193Z","avatar_url":"https://github.com/Kodiererin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💰 ExpenseMate\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/images/icon.png\" alt=\"ExpenseMate Logo\" width=\"120\" height=\"120\" /\u003e\n  \n  **A beautiful, modern expense tracking app built with React Native and Expo**\n  \n  [![Expo](https://img.shields.io/badge/Expo-53.0.17-000020?style=for-the-badge\u0026logo=expo\u0026logoColor=white)](https://expo.dev/)\n  [![React Native](https://img.shields.io/badge/React_Native-0.79.5-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB)](https://reactnative.dev/)\n  [![TypeScript](https://img.shields.io/badge/TypeScript-5.8.3-007ACC?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n  [![Firebase](https://img.shields.io/badge/Firebase-11.10.0-FFCA28?style=for-the-badge\u0026logo=firebase\u0026logoColor=black)](https://firebase.google.com/)\n  \n  [🚀 Quick Start](#-quick-start) | [📖 Features](#-features) | [🤝 Contributing](#-contributing)\n\u003c/div\u003e\n\n---\n\n## 📱 Screenshots\n\nBelow are previews of ExpenseMate in both Light and Dark modes. You can scroll horizontally to see all screens.\n\n\u003cdiv style=\"overflow-x: auto; white-space: nowrap; padding: 8px 0;\"\u003e\n  \u003cdiv style=\"display: inline-block; vertical-align: top; margin-right: 24px;\"\u003e\n    \u003cdiv align=\"center\" style=\"font-weight: bold; margin-bottom: 8px;\"\u003e🌞 Light Mode\u003c/div\u003e\n    \u003cimg src=\"./assets/ScreenShots/LightMode/Screenshot 2025-07-18 002445.png\" alt=\"Home Light\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/LightMode/Screenshot 2025-07-18 002451.png\" alt=\"Home Light\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/LightMode/Screenshot 2025-07-18 002502.png\" alt=\"Home Light\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/LightMode/Screenshot 2025-07-18 002510.png\" alt=\"Home Light\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/LightMode/Screenshot 2025-07-18 002529.png\" alt=\"Home Light\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/LightMode/Screenshot 2025-07-18 002550.png\" alt=\"Home Light\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/LightMode/Screenshot 2025-07-18 002604.png\" alt=\"Home Light\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n  \u003c/div\u003e\n  \u003cdiv style=\"display: inline-block; vertical-align: top;\"\u003e\n    \u003cdiv align=\"center\" style=\"font-weight: bold; margin-bottom: 8px;\"\u003e🌚 Dark Mode\u003c/div\u003e\n    \u003cimg src=\"./assets/ScreenShots/DarkMode/home.png\" alt=\"Home Dark\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/DarkMode/history.png\" alt=\"Home Dark\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/DarkMode/history1.png\" alt=\"Home Dark\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/DarkMode/investments.png\" alt=\"Home Dark\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/DarkMode/investments1.png\" alt=\"Home Dark\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/DarkMode/investments2.png\" alt=\"Home Dark\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n    \u003cimg src=\"./assets/ScreenShots/DarkMode/profile.png\" alt=\"Home Dark\" width=\"200\" style=\"margin-right:8px;\"/\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\n## ✨ Features\n\n### 💸 **Expense Management**\n\n- 📊 **Smart Categorization** - Organize expenses with customizable categories (Food, Travel, Shopping, Bills, etc.)\n- 💰 **Real-time Tracking** - Add expenses instantly with amount, description, and date\n- 📅 **Date Flexibility** - Track expenses for any date, not just today\n- 🔍 **Advanced Filtering** - Filter expenses by month, year, and category\n\n### 📈 **Analytics \u0026 Insights**\n\n- 📊 **Beautiful Charts** - Interactive pie charts showing expense distribution\n- 📅 **Monthly Overview** - Track spending patterns month by month\n- 💡 **Smart Insights** - Get insights into your spending habits\n- 📋 **Export Ready** - Share expense summaries easily\n\n### 🎯 **Budget Goals**\n\n- 🎯 **Goal Setting** - Set monthly budget goals for each category\n- 📊 **Progress Tracking** - Visual progress indicators for your goals\n- ⚡ **Real-time Updates** - Goals update automatically as you add expenses\n- 🏆 **Achievement System** - Track your budget success rate\n\n### 🎨 **Modern UI/UX**\n\n- 🌙 **Dark/Light Theme** - Automatic theme switching based on system preference\n- 📱 **Native Feel** - Smooth animations and native performance\n- ♿ **Accessibility** - Full accessibility support with screen readers\n- 🎯 **Intuitive Navigation** - Clean tab-based navigation with visual feedback\n\n---\n\n## 🏗️ **Tech Stack**\n\n| Technology | Purpose | Version |\n|------------|---------|---------|\n| **Expo** | React Native framework | 53.0.17 |\n| **React Native** | Mobile app development | 0.79.5 |\n| **TypeScript** | Type safety | 5.8.3 |\n| **Expo Router** | File-based routing | 5.1.3 |\n| **Firebase** | Backend \u0026 database | 11.10.0 |\n| **React Native Chart Kit** | Data visualization | 6.12.0 |\n| **React Native Gesture Handler** | Touch interactions | 2.24.0 |\n| **React Native Reanimated** | Smooth animations | 3.17.5 |\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- **Node.js** (v18 or higher)\n- **npm** or **yarn**\n- **Expo CLI** (`npm install -g @expo/cli`)\n- **Android Studio** (for Android development)\n- **Xcode** (for iOS development, macOS only)\n\n### Installation\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/yourusername/ExpenseMate.git\n   cd ExpenseMate\n   ```\n\n2. **Install dependencies**\n\n   ```bash\n   npm install\n   ```\n\n3. **Set up environment variables**\n\n4. **Start the development server**\n\n   ```bash\n   npm start\n   ```\n\n5. **Run on your device**\n   - **Android**: `npm run android` or scan QR code with Expo Go\n   - **iOS**: `npm run ios` or scan QR code with Expo Go\n   - **Web**: `npm run web`\n\n---\n\n### EAS Build Setup (Optional)\n\nFor building APK/IPA files:\n\n1. **Install EAS CLI**\n\n   ```bash\n   npm install -g eas-cli\n   ```\n\n2. **Login to Expo**\n\n   ```bash\n   eas login\n   ```\n\n3. **Build for Android**\n\n   ```bash\n   npm run build:android\n   ```\n\n4. **Build for iOS**\n\n   ```bash\n   npm run build:ios\n   ```\n\n---\n\n## 🎯 **Features Deep Dive**\n\n### 💰 **Add Expenses**\n\n- **Smart Categories**: Pre-defined categories with emojis\n- **Custom Categories**: Add your own categories\n- **Amount Validation**: Prevents invalid inputs\n- **Date Selection**: Pick any date for your expense\n\n### 📊 **Analytics Dashboard**\n\n- **Monthly View**: See all expenses for any month/year\n- **Category Breakdown**: Pie chart showing expense distribution\n- **Total Calculations**: Automatic sum calculations\n- **Refresh Support**: Pull-to-refresh for latest data\n\n### 🎯 **Budget Goals**\n\n- **Monthly Targets**: Set budget goals for each category\n- **Visual Progress**: Progress bars showing goal completion\n- **Real-time Updates**: Goals update as you add expenses\n\n### ⚙️ **Settings \u0026 Profile**\n\n- **Theme Toggle**: Switch between light and dark themes\n- **Data Management**: Clear cache and manage data\n- **App Information**: Version and developer info\n\n---\n\n## 🧪 **Development**\n\n### Available Scripts\n\n| Command | Description |\n|---------|-------------|\n| `npm start` | Start Expo development server |\n| `npm run android` | Run on Android device/emulator |\n| `npm run ios` | Run on iOS device/simulator |\n| `npm run web` | Run on web browser |\n| `npm run lint` | Run ESLint code linting |\n| `npm run build:android` | Build Android APK/AAB |\n| `npm run build:ios` | Build iOS IPA |\n| `npm run prebuild` | Generate native code |\n\n---\n\n## 🤝 Contributing\n\nWe love contributions! Here's how you can help:\n\n### 🐛 **Bug Reports**\n\nFound a bug? [Open an issue](https://github.com/yourusername/ExpenseMate/issues/new?template=bug_report.md) with:\n\n- Steps to reproduce\n- Expected vs actual behavior\n- Screenshots if applicable\n- Device/OS information\n\n### 💡 **Feature Requests**\n\nHave an idea? [Request a feature](https://github.com/yourusername/ExpenseMate/issues/new?template=feature_request.md) with:\n\n- Detailed description\n- Use case scenarios\n- Mockups or examples (if applicable)\n\n### 🛠️ **Code Contributions**\n\n1. **Fork the repository**\n2. **Create a feature branch**\n\n   ```bash\n   git checkout -b feature/amazing-feature\n   ```\n\n3. **Make your changes**\n4. **Run quality checks**\n\n   ```bash\n   npm run lint\n   npx tsc --noEmit\n   ```\n\n5. **Commit your changes**\n\n   ```bash\n   git commit -m 'Add amazing feature'\n   ```\n\n6. **Push to your branch**\n\n   ```bash\n   git push origin feature/amazing-feature\n   ```\n\n7. **Open a Pull Request**\n\n### 📋 **Development Guidelines**\n\n- Follow the existing code style\n- Add TypeScript types for new code\n- Test on both Android and iOS\n- Update documentation if needed\n- Add comments for complex logic\n\n---\n\n## 📄 **License**\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## **Acknowledgments**\n\n- **Expo Team** - For the amazing React Native framework\n- **Firebase** - For the reliable backend services\n- **React Native Community** - For the awesome libraries\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \n  **⭐ Star this repo if you find it helpful!**\n  \n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkodiererin%2Fexpensemate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkodiererin%2Fexpensemate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkodiererin%2Fexpensemate/lists"}