{"id":26929259,"url":"https://github.com/krawmire/profitocracy","last_synced_at":"2025-04-09T07:06:53.715Z","repository":{"id":68495661,"uuid":"579065126","full_name":"KrawMire/profitocracy","owner":"KrawMire","description":"Multi currency personal budget control mobile application following 50-30-20 principle. Created using .NET MAUI","archived":false,"fork":false,"pushed_at":"2025-03-31T18:49:54.000Z","size":66682,"stargazers_count":90,"open_issues_count":7,"forks_count":22,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-04-09T07:06:26.786Z","etag":null,"topics":["android","budget","c-sharp","clean-architecture","csharp","ddd","domain-driven-design","dotnet","dotnet-maui","economy","finance","ios","maui","maui-android","maui-app","maui-ios","mobile","mobile-app"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KrawMire.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":"2022-12-16T15:13:30.000Z","updated_at":"2025-04-02T05:37:20.000Z","dependencies_parsed_at":"2024-05-01T22:27:52.635Z","dependency_job_id":"9c0db24d-a49a-45dd-a6d2-b2dc739fd403","html_url":"https://github.com/KrawMire/profitocracy","commit_stats":null,"previous_names":["krawmire/profitocracy-maui","krawmire/profitocracy"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KrawMire%2Fprofitocracy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KrawMire%2Fprofitocracy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KrawMire%2Fprofitocracy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KrawMire%2Fprofitocracy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KrawMire","download_url":"https://codeload.github.com/KrawMire/profitocracy/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247994121,"owners_count":21030050,"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","budget","c-sharp","clean-architecture","csharp","ddd","domain-driven-design","dotnet","dotnet-maui","economy","finance","ios","maui","maui-android","maui-app","maui-ios","mobile","mobile-app"],"created_at":"2025-04-02T05:07:58.042Z","updated_at":"2025-04-09T07:06:53.684Z","avatar_url":"https://github.com/KrawMire.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Android](https://img.shields.io/badge/Android-3DDC84?logo=android\u0026logoColor=white)\n![iOS](https://img.shields.io/badge/iOS-000000?logo=apple\u0026logoColor=white)\n![GitHub Releases](https://img.shields.io/github/downloads/KrawMire/profitocracy/total?label=Downloads)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/KrawMire/profitocracy?label=Latest%20Release)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/KrawMire/profitocracy)\n![GitHub issues](https://img.shields.io/github/issues/KrawMire/profitocracy?label=Issues)\n![GitHub Repo stars](https://img.shields.io/github/stars/KrawMire/profitocracy?style=social)\n![GitHub](https://img.shields.io/github/license/KrawMire/profitocracy?label=License)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/main_banner.png\" alt=\"Title image\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"left\"\u003e\n    \u003ca href=\"https://apps.apple.com/rs/app/profitocracy/id6503658740\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/distribution/download_app_store.svg\" alt=\"App Store Download\" height=\"150\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\nWelcome to the source code of **Profitocracy**.\n\n**Profitocracy** is a powerful budget management app designed to help users track their expenses effortlessly while following the 50-30-20 budgeting rule.\n\n# Key Features of Profitocracy\n\n- 💰 **Track Your Expenses**. Stay on top of your finances by organizing your spending effortlessly using the [50-30-20 rule](#503020rule).\n- 📊 **Customize Spending Categories**. Create, set budgets, and easily monitor your spending in personalized categories.\n- 📅 **Monthly Budget Planning**. Automatically generate a tailored budget to make every month stress-free.\n- 🔒 **Complete Data Privacy**. Rest assured that your data is secure, Profitocracy does not share your information with third parties. Everything is stored locally on your device.\n- 🌍 **Multi-Currency Support**. Track expenses in different currencies with seamless conversion for global users.\n- 📈 **Visualize Your Spending with Charts**. Gain clear insights into your expenses with beautifully crafted charts and graphs.\n- 👥 **Multiple Profiles**. Manage separate budgets or accounts for different individuals or purposes all within one app.\n- 💻 **Open-Source**. Profitocracy is open-source, ensuring transparency and the support of a thriving community for constant improvements.\n\n## Android Preview\n\n\u003cp align=\"left\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/android/transactions_banner.ap.png\" alt=\"Transactions\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/android/categories_banner.ap.png\" alt=\"Categories\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/android/multiprofiles_banner.ap.png\" alt=\"Multi-Profiles\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/android/charts_banner.ap.png\" alt=\"Charts\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/android/theme_banner.ap.png\" alt=\"Theme\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/android/multicurrency_banner.ap.png\" alt=\"Multi-Currency\" width=\"150\"/\u003e\n\u003c/p\u003e\n\n## iOS Preview\n\n\u003cp align=\"left\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/ios/transactions_banner.png\" alt=\"Transactions\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/ios/categories_banner.png\" alt=\"Categories\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/ios/multiprofiles_banner.png\" alt=\"Multi-Profiles\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/ios/charts_banner.png\" alt=\"Charts\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/ios/theme_banner.png\" alt=\"Theme\" width=\"150\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/banners/ios/multicurrency_banner.png\" alt=\"Multi-Currency\" width=\"150\"/\u003e\n\u003c/p\u003e\n\n# Installation\n\n\u003e [!NOTE]\n\u003e For now, Profitocracy is published only in the Apple App Store. I hope it will be also available at Google Play Market soon.\n\n## Android\n\nTo install Profitocracy to an Android device, go to the [latest release](https://github.com/KrawMire/profitocracy-maui/releases/latest) and install an attached *.apk* file.\nThen click on it and follow the instructions.\n\n\u003e If you want to try out a specific version of Profitocracy, go to\n\u003e [the list of releases](https://github.com/KrawMire/profitocracy-maui/releases)\n\u003e and select the version you would like to install.\n\n## iOS\n\nYou can download the Profitocracy on the Apple App Store by following [this link](https://apps.apple.com/rs/app/profitocracy/id6503658740) or by clicking on the following image:\n\n\u003cp align=\"left\"\u003e\n    \u003ca href=\"https://apps.apple.com/rs/app/profitocracy/id6503658740\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/distribution/download_app_store.svg\" alt=\"App Store Download\" height=\"150\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n# More About Profitocracy\n\n## \u003ca name=\"503020rule\"\u003e\u003c/a\u003e What is a 50-30-20 rule\n\nThe 50-30-20 rule is a common way to allocate the spending categories in your personal or household budget.\nThe rule targets 50% of your after-tax income toward necessities, 30% toward things you don’t need—but make\nlife a little nicer and the final 20% toward paying down debt and/or adding to your savings.\n\n## Terminologies Used in Profitocracy\n\n### 💼 Profile\n\nA **Profile** represents all your financial activity in one place. It tracks your expenses and calculates amounts for primary, secondary, and savings expenses. Additionally, it provides insights into your daily spending as well as categorized expenses for better organization.\n\n### 🧾 Transaction\n\nA **Transaction** is an operation that moves funds. It can either be an **income** (e.g., your salary) or an **expense** (e.g., groceries, rent). For expense transactions, you’ll need to specify:\n- The **type** of expense: primary, secondary, or savings.\n- The **amount** spent.\n\nYou can also optionally provide additional details such as:\n- **Spending category** (default is \"None\").\n- **Description** of the transaction.\n- **Date** of the operation.\n\n### 💵 Actual and Planned Amounts of Expenses\n\nIn Profitocracy, most of the data displayed on the **Home Screen** revolves around expenses. An **expense** is represented by two key values:\n- **Actual Amount:** The real amount of money spent for a specific type or category.\n- **Planned Amount:** The amount Profitocracy suggests as your spending limit for each category or type.\n\nThis balance between actual and planned amounts helps you stay in control of your financial goals.\n\n### 📊 Category\n\nA **Category** is a grouping tool for your transactions. Each category can be customized with:\n- A **name** (e.g., Food, Entertainment).\n- An optional **planned amount** for the month (set during creation on the **Settings Screen**).\n\nOnce created, you can track your category-wise spending on the **Home Screen.**\n\n- If a planned amount is set, Profitocracy compares your spending against it for better tracking.\n- If no planned amount is defined, the app simply displays the total expenses for the category during the ongoing month.\n\n# Gettings Started\n\nAll the steps were recorded on iOS device, but it is also correct for Android and other operating systems.\nThere we will look at all the steps to set up **Profitocracy** for comfortable use.\n\n| Description                                                                                                                                    | Screen Recording                                                                                                                 |\n|------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------|\n| 1. **Creating Your First Profile**. Learn how to set up your first profile when launching the app for the first time.                          | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/1_first_profile.gif\" /\u003e        |\n| 2. **Adding a Second Profile**. Discover how to create and manage an another profile directly from the settings page.                          | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/2_second_profile.gif\" /\u003e       |\n| 3. **Switching Profiles**. See how to set the second profile as the current active one for personalized budget tracking.                       | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/3_set_current_profile.gif\" /\u003e  |\n| 4. **Editing a Profile**. Learn how to update or modify an existing profile with ease.                                                         | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/4_profile_edit.gif\" /\u003e         |\n| 5. **Creating Spending Categories**. Walk through the process of creating your first two spending categories to organize expenses effectively. | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/5_first_category.gif\" /\u003e       |\n| 6. **Editing a Category**. Watch how to edit an existing category to refine your financial organization.                                       | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/6_edit_category.gif\" /\u003e        |\n| 7. **Creating a Main Spending Transaction**. See how to add a new transaction with the Main spending type.                                     | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/7_main_transaction.gif\" /\u003e     |\n| 8. **Saving in a Different Currency (EUR)**. Learn how to create a saving transaction in EUR for managing multi-currency budgets.              | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/8_saving_transaction.gif\" /\u003e   |\n| 9. **Recording Income Transactions**. Walk through the steps for adding an income transaction to track earnings.                               | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/9_income.gif\" /\u003e               |\n| 10. **Handling Withdrawals from Savings (EUR)**. Watch how to create a transaction for withdrawing funds from savings in EUR.                  | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/10_withdraw.gif\" /\u003e            |\n| 11. **Visualizing Expenses with Charts**. Explore the overview page to see how expenses are visualized through insightful and detailed charts. | \u003cimg src=\"https://raw.githubusercontent.com/KrawMire/profitocracy/dev/docs/assets/getting_started/11_overview.gif\" /\u003e            |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrawmire%2Fprofitocracy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkrawmire%2Fprofitocracy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrawmire%2Fprofitocracy/lists"}