{"id":30657313,"url":"https://github.com/deaneeth/budgetme-finance-manager","last_synced_at":"2026-04-09T20:32:31.883Z","repository":{"id":311523018,"uuid":"1043942051","full_name":"deaneeth/budgetme-finance-manager","owner":"deaneeth","description":"A comprehensive personal finance management desktop application built with C# and WinForms. Track expenses, manage debts, monitor investments, and visualize your financial health with customizable dashboards and progress bars. Take control of your financial future with this all-in-one budgeting solution.","archived":false,"fork":false,"pushed_at":"2025-08-25T00:16:46.000Z","size":592,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-25T03:09:39.287Z","etag":null,"topics":["budget-management","csharp","debt-management","dotnet","expense-tracker","financial-dashboard","money-management","personal-finance","sql-server","winforms"],"latest_commit_sha":null,"homepage":"","language":"C#","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/deaneeth.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,"zenodo":null}},"created_at":"2025-08-25T00:01:56.000Z","updated_at":"2025-08-25T00:19:01.000Z","dependencies_parsed_at":"2025-08-25T03:09:44.536Z","dependency_job_id":"043af4e0-3a3c-4514-aad4-a84f9cfaa254","html_url":"https://github.com/deaneeth/budgetme-finance-manager","commit_stats":null,"previous_names":["deaneeth/budgetme-finance-manager"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/deaneeth/budgetme-finance-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fbudgetme-finance-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fbudgetme-finance-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fbudgetme-finance-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fbudgetme-finance-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deaneeth","download_url":"https://codeload.github.com/deaneeth/budgetme-finance-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deaneeth%2Fbudgetme-finance-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272971549,"owners_count":25024099,"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-31T02:00:09.071Z","response_time":79,"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":["budget-management","csharp","debt-management","dotnet","expense-tracker","financial-dashboard","money-management","personal-finance","sql-server","winforms"],"created_at":"2025-08-31T11:13:02.832Z","updated_at":"2026-04-09T20:32:26.857Z","avatar_url":"https://github.com/deaneeth.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💰 BudgetMe - Your Personal Finance Manager\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![Language: C#](https://img.shields.io/badge/Language-C%23-blue.svg)](https://docs.microsoft.com/en-us/dotnet/csharp/)\n[![Platform: Windows](https://img.shields.io/badge/Platform-Windows-lightgrey.svg)](https://www.microsoft.com/en-us/windows)\n[![Framework: .NET](https://img.shields.io/badge/.NET-4.7.2-purple.svg)](https://dotnet.microsoft.com/)\n[![Database: SQL Server](https://img.shields.io/badge/Database-SQL%20Server-red.svg)](https://www.microsoft.com/en-us/sql-server)\n\n\u003e Take control of your financial future with BudgetMe - a comprehensive desktop application that helps you track expenses, manage debts, monitor investments, and visualize your financial health all in one place!\n\n![BudgetMe Dashboard Preview](assets/dashboard.png)\n\n## 📋 Table of Contents\n\n- [Features](#-features)\n- [System Requirements](#-system-requirements)\n- [Installation Guide](#-installation-guide)\n- [Usage Instructions](#-usage-instructions)\n- [Project Structure](#-project-structure)\n- [Database Schema](#-database-schema)\n- [Screenshots](#-screenshots)\n- [Technologies Used](#-technologies-used)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n## ✨ Features\n\n### 🔐 User Authentication\n\n- **Secure Login \u0026 Registration**: Protect your financial data with a personal account\n- **Password Recovery**: Easily recover access to your account\n\n### 📊 Interactive Dashboard\n\n- **Financial Overview**: Get a comprehensive view of your total balance\n- **Recent Transactions**: Quick access to your most recent financial activities\n- **Visual Progress**: Circular progress bars for goal tracking and spending limits\n\n### 💵 Daily Expense Tracker\n\n- **Quick Entry Forms**: Efficiently log your daily expenses\n- **Categorization**: Organize expenses by customizable categories\n- **Real-time Updates**: Watch your spending patterns evolve as you add entries\n\n### 💸 Debt Management\n\n- **Debt Tracking**: Monitor all your debts in one place\n- **Repayment Scheduling**: Plan and schedule your debt repayments\n- **Payment Notifications**: Get alerts for upcoming payment deadlines\n\n### 📈 Investment Portfolio\n\n- **Investment Tracking**: Monitor your investment holdings\n- **Performance Metrics**: Track the performance of your investments over time\n- **Summary Views**: Get a birds-eye view of your entire investment portfolio\n\n### 📝 Transaction Management\n\n- **Multiple Transaction Types**: Support for debt, investment, and daily transactions\n- **Detailed History**: Comprehensive transaction history with filtering options\n- **Search Functionality**: Easily find specific transactions\n\n### 📊 Data Visualization\n\n- **Financial Health Indicators**: Visual representations of your financial status\n- **Progress Tracking**: Monitor your savings and budgeting goals\n- **Trend Analysis**: Analyze your spending patterns over time\n\n## 🖥 System Requirements\n\n- **Operating System**: Windows 10 or later\n- **Processor**: 1.6 GHz or faster\n- **RAM**: 2 GB minimum (4 GB recommended)\n- **Disk Space**: 100 MB available\n- **Framework**: .NET Framework 4.7.2 or higher\n- **Database**: Microsoft SQL Server LocalDB (included with Visual Studio)\n- **Display**: 1366×768 or higher resolution\n\n## 🚀 Installation Guide\n\n### Prerequisites\n\n- Microsoft Visual Studio 2017 or later\n- SQL Server LocalDB (comes with Visual Studio)\n- .NET Framework 4.7.2 Development Tools\n\n### Step-by-Step Installation\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/deaneeth/budgetme-finance-manager.git\n   ```\n\n2. **Navigate to the project directory**\n\n   ```bash\n   cd budgetme-finance-manager\n   ```\n\n3. **Open the Solution**\n   - Launch Visual Studio\n   - Open `BudgetMe.sln` from the repository folder\n\n4. **Restore NuGet Packages**\n   - Right-click on the Solution in Solution Explorer\n   - Select \"Restore NuGet Packages\"\n   - Wait for the process to complete\n\n5. **Database Configuration**\n   - The application uses LocalDB with a relative path (`|DataDirectory|\\BudgetMeDatabases.mdf`)\n   - No manual configuration needed if using the default setup\n   - All connection strings use Integrated Security (no passwords are stored in the code)\n\n6. **Build the Solution**\n   - Select Build → Build Solution (or press Ctrl+Shift+B)\n   - Ensure there are no build errors\n\n7. **Run the Application**\n   - Press F5 or click the \"Start\" button to launch the application\n   - The application will open at the Login screen\n\n## 🎮 Usage Instructions\n\n### First-Time Setup\n\n1. **Create a New Account**\n   - Launch the application\n   - Click \"Sign Up\" on the login screen\n   - Fill in your details and create a password\n   - Click \"Register\" to create your account\n\n2. **Login to Your Account**\n   - Enter your username and password\n   - Click \"Login\" to access your dashboard\n\n### Using the Dashboard\n\n- The dashboard provides an overview of your financial status\n- Use the sidebar to navigate between different modules\n- Circular progress bars visualize your budget utilization\n\n### Tracking Daily Expenses\n\n1. Navigate to \"Daily Tracker\" from the sidebar\n2. Enter expense details (amount, category, description)\n3. Click \"Add\" to record your expense\n4. View your daily spending summary and remaining budget\n\n### Managing Debts\n\n1. Navigate to \"Debt Manager\" from the sidebar\n2. Add new debts with creditor details and repayment plans\n3. Record payments toward existing debts\n4. Monitor your remaining balances and upcoming payments\n\n### Tracking Investments\n\n1. Navigate to \"Investment\" from the sidebar\n2. Add your investment holdings with details\n3. Update values as your investments change\n4. View performance metrics and summary data\n\n### Recording Transactions\n\n1. Select the appropriate transaction type from the menu\n2. Fill in the required details for the transaction\n3. Save the transaction to update your financial records\n\n## 📁 Project Structure\n\nThe BudgetMe project follows a standard Windows Forms application structure:\n\n```markdown\nBudgetMe/\n├── BudgetMe.sln                # Solution file\n├── README.md                   # Project documentation\n├── SQLQuery1.sql               # Database queries\n├── BudgetMe/                   # Main project folder\n│   ├── App.config              # Application configuration\n│   ├── BudgetMe.csproj         # Project file\n│   ├── Database Files          # LocalDB database files (not included in repo)\n│   ├── Program.cs              # Application entry point\n│   ├── Form Files              # Windows Forms (.cs, .Designer.cs, .resx)\n│   │   ├── Login.cs            # Login screen\n│   │   ├── Signup.cs           # Registration screen\n│   │   ├── AllDash.cs          # Main dashboard\n│   │   ├── DailyTracker.cs     # Expense tracking\n│   │   ├── DebtManager.cs      # Debt management\n│   │   ├── Investment.cs       # Investment tracking\n│   │   ├── Transaction.cs      # Transaction management\n│   │   └── ...                 # Other form files\n│   ├── Properties/             # Project properties\n│   ├── Resources/              # Application resources\n│   ├── bin/                    # Binary output\n│   └── obj/                    # Object files\n└── packages/                   # NuGet packages\n```\n\n## 🗃 Database Schema\n\nBudgetMe uses a SQL Server LocalDB with the following main tables:\n\n### Users Table\n\n- Stores user authentication information and profile data\n- Primary key: UserID\n- Fields: Username, Password, Email, etc.\n\n### Transactions Table\n\n- Records all financial transactions\n- Primary key: TransactionID\n- Fields: UserID (FK), Amount, Type, Category, Date, Description\n\n### Debts Table\n\n- Tracks debt information\n- Primary key: DebtID\n- Fields: UserID (FK), Creditor, Amount, Interest, DueDate, Status\n\n### Investments Table\n\n- Manages investment holdings\n- Primary key: InvestmentID\n- Fields: UserID (FK), Name, Amount, PurchaseDate, CurrentValue\n\n### Daily Expenses Table\n\n- Records day-to-day spending\n- Primary key: ExpenseID\n- Fields: UserID (FK), Date, Category, Amount, Description\n\n## 📸 Screenshots\n\n### Main Dashboard\n\n![BudgetMe Dashboard Preview](assets/dashboard.png)\n\n### Transaction Management\n\n![Add Transaction Screen](assets/add-transaction.png)\n\n### Other Screens\n\n*More screenshots will be added as the application is developed further.*\n\n## 🛠 Technologies Used\n\n- **C#**: Primary programming language\n- **.NET Framework 4.7.2**: Application framework\n- **Windows Forms**: UI framework\n- **SQL Server LocalDB**: Database\n- **ADO.NET**: Data access\n- **CircularProgressBar**: Visual component for progress tracking\n- **BouncyCastle.Cryptography**: Security components\n- **Various .NET Libraries**: For additional functionality\n\n## � Setup Instructions for Contributors\n\n### Database Setup\n\nSince the database files (`.mdf` and `.ldf`) are not included in the repository for security and size reasons, you'll need to initialize your own database:\n\n1. **Create a New Database**\n   - The application is configured to look for `BudgetMeDatabases.mdf` in the application directory\n   - Visual Studio will automatically create this file when you run the application for the first time\n\n2. **Initialize Database Schema**\n   - Execute the SQL queries in `SQLQuery1.sql` to set up the required tables\n   - Alternatively, the application can auto-create tables on first run\n\n### .gitignore Configuration\n\nThis repository uses a `.gitignore` file to prevent committing sensitive or unnecessary files:\n\n- Database files (`.mdf`, `.ldf`)\n- Compiled binaries (`bin/`, `obj/`)\n- User-specific settings (`.suo`, `.user`)\n- NuGet packages (`packages/`)\n\n## �👨‍💻 Contributing\n\nContributions to BudgetMe are welcome! Here's how you can contribute:\n\n1. **Fork the Repository**\n   - Create a fork of this project to your GitHub account\n\n2. **Create a Branch**\n\n   ```powershell\n   git checkout -b feature/your-feature-name\n   ```\n\n3. **Make Changes**\n   - Implement your feature or fix\n   - Ensure code follows existing style patterns\n\n4. **Test Your Changes**\n   - Verify your changes work as expected\n   - Check for any potential issues\n\n5. **Submit a Pull Request**\n   - Create a PR with a clear description of your changes\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\n⭐ **Star this repository if you find it useful!** ⭐\n\n\u003e Last Updated: August 25, 2023\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeaneeth%2Fbudgetme-finance-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeaneeth%2Fbudgetme-finance-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeaneeth%2Fbudgetme-finance-manager/lists"}