{"id":29953733,"url":"https://github.com/bocaletto-luca/budgetbee","last_synced_at":"2025-08-03T15:11:05.431Z","repository":{"id":305412987,"uuid":"1022818884","full_name":"bocaletto-luca/BudgetBee","owner":"bocaletto-luca","description":"BudgetBee is a full-featured, single-page personal budget planner designed to run entirely in your browser. With no server or database required, you can instantly log income and expenses, categorize transactions, and view interactive tables and charts—all powered by LocalStorage for persistence. Add, edit, or delete entries on the fly, switch ...","archived":false,"fork":false,"pushed_at":"2025-07-19T22:46:29.000Z","size":22,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-20T00:55:13.859Z","etag":null,"topics":["bocaletto-luca","budget","budget-app","budgetbee","css3","html-css-javascript","html5","javascript","online","webapp"],"latest_commit_sha":null,"homepage":"https://bocaletto-luca.github.io/","language":"HTML","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/bocaletto-luca.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-07-19T22:39:38.000Z","updated_at":"2025-07-19T23:56:53.000Z","dependencies_parsed_at":"2025-07-20T01:08:01.599Z","dependency_job_id":null,"html_url":"https://github.com/bocaletto-luca/BudgetBee","commit_stats":null,"previous_names":["bocaletto-luca/budgetbee"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bocaletto-luca/BudgetBee","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FBudgetBee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FBudgetBee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FBudgetBee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FBudgetBee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bocaletto-luca","download_url":"https://codeload.github.com/bocaletto-luca/BudgetBee/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bocaletto-luca%2FBudgetBee/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268563823,"owners_count":24270653,"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-03T02:00:12.545Z","response_time":2577,"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":["bocaletto-luca","budget","budget-app","budgetbee","css3","html-css-javascript","html5","javascript","online","webapp"],"created_at":"2025-08-03T15:10:58.572Z","updated_at":"2025-08-03T15:11:05.425Z","avatar_url":"https://github.com/bocaletto-luca.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BudgetBee\n\nBudgetBee is a full-featured, single-page personal budget planner designed to run entirely in your browser. With no server or database required, you can instantly log income and expenses, categorize transactions, and view interactive tables and charts—all powered by LocalStorage for persistence. Add, edit, or delete entries on the fly, switch between light and dark modes, and back up your data via JSON export/import. Use BudgetBee to gain clarity on your financial habits: visualize monthly expense breakdowns with a pie chart, track your net balance over the last six months with a bar chart, and efficiently manage your cash flow in one professional, responsive interface.\n\n---\n\n## Features\n\n- **Income \u0026 Expense Tracking**  \n  Log any transaction with type (income or expense), category, amount, date, and optional note.\n\n- **Interactive Table (Tabulator)**  \n  Inline editing, sorting, filtering, and delete buttons for rapid CRUD operations.\n\n- **Charts \u0026 Insights (Chart.js)**  \n  - Pie chart for current month’s expense distribution by category  \n  - Bar chart for net balance over the last six months\n\n- **Data Persistence**  \n  Transactions are saved in `localStorage`—no backend required.\n\n- **Export \u0026 Import**  \n  Download or upload your entire budget as a JSON file for backup, transfer, or synchronization.\n\n- **Dark/Light Mode**  \n  Toggle theme to suit your environment and reduce eye strain.\n\n- **Client-Side Only**  \n  Runs on any static hosting (GitHub Pages, Netlify, local HTTP server).\n\n- **Cross-Device \u0026 Responsive**  \n  Works flawlessly on desktop, tablet, and mobile browsers.\n\n---\n\n## Demo\n\nView the live demo on GitHub Pages:  \nhttps://bocaletto-luca.github.io/BudgetBee/index.html\n\n---\n\n## Installation\n\n1. **Clone the repository**  \n   ```bash\n   git clone https://github.com/bocaletto-luca/BudgetBee.git\n   cd BudgetBee\n   ```\n2. **Serve with a static HTTP server**  \n   - **Python 3**  \n     ```bash\n     python3 -m http.server 8000\n     ```\n   - **Node.js (http-server)**  \n     ```bash\n     npx http-server . -p 8000\n     ```\n3. **Open in browser**  \n   Navigate to `http://localhost:8000/index.html`.\n\n---\n\n## Usage\n\n1. **Add a transaction**  \n   - Select **Expense** or **Income**  \n   - Enter **Category**, **Amount**, **Date**, and optional **Note**  \n   - Click **Add**\n\n2. **Edit or delete**  \n   - Inline edit any cell in the table  \n   - Click the ❌ button to remove a transaction\n\n3. **View charts**  \n   - Pie chart shows expenses by category for the current month  \n   - Bar chart shows net balance trend over the last six months\n\n4. **Export / Import**  \n   - Click **Export JSON** to download your data file  \n   - Click **Import JSON** and select a file to restore\n\n5. **Toggle Dark Mode**  \n   - Click the 🌙 / ☀️ button to switch between dark and light themes\n\n---\n\n## Customization\n\n- **Colors \u0026 Styles**  \n  Edit CSS variables in the `\u003cstyle\u003e` block of `index.html`:\n  ```css\n  :root {\n    --primary: #28a745;     /* Main brand color */\n    --expense: #dc3545;     /* Expense bar color */\n    --income: #17a2b8;      /* Income bar color */\n    /* ... */\n  }\n  ```\n- **Date Formatting**  \n  Adjust the Day.js formatter calls in the script to change how dates are displayed.\n- **Chart Options**  \n  Modify the `new Chart()` configurations in the `updateCharts()` function for different visuals.\n\n---\n\n## File Structure\n\n```\nBudgetBee/\n├── index.html       # Single-page app (HTML, CSS, JS)\n├── LICENSE          # GNU GPL v3.0 license\n└── README.md        # This documentation\n```\n\n---\n\n## Contributing\n\nYour feedback and contributions are welcome! To contribute:\n\n1. **Fork** the repository  \n2. **Create a feature branch**  \n   ```bash\n   git checkout -b feature/my-new-feature\n   ```\n3. **Commit your changes**  \n   ```bash\n   git commit -m \"Add awesome feature\"\n   ```\n4. **Push to your branch**  \n   ```bash\n   git push origin feature/my-new-feature\n   ```\n5. **Open a Pull Request** on GitHub\n\nPlease ensure compatibility across major browsers and maintain the existing code style.\n\n---\n\n## License\n\nBudgetBee is licensed under the **GNU General Public License v3.0**.  \nSee the [LICENSE](LICENSE) file for full details.\n\n---\n\n## Author\n\n**Bocaletto Luca**  \n- GitHub: [@bocaletto-luca](https://github.com/bocaletto-luca)  \n- Repository: [BudgetBee](https://github.com/bocaletto-luca/BudgetBee)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbocaletto-luca%2Fbudgetbee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbocaletto-luca%2Fbudgetbee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbocaletto-luca%2Fbudgetbee/lists"}