{"id":20417976,"url":"https://github.com/yusufyusie/budget-app","last_synced_at":"2026-05-10T05:02:18.315Z","repository":{"id":221792231,"uuid":"754341947","full_name":"yusufyusie/budget-app","owner":"yusufyusie","description":"The SpendSmart app keeps track of all your expences. You can create, edit, delete categories and transactions. Each transaction is associeated with 1 or many categories. Built with RoR.","archived":false,"fork":false,"pushed_at":"2024-02-13T03:16:44.000Z","size":3108,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-01-15T14:12:12.433Z","etag":null,"topics":["devise","postgresql","ruby-on-rails","testing"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/yusufyusie.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":"2024-02-07T21:25:40.000Z","updated_at":"2024-03-11T13:32:18.000Z","dependencies_parsed_at":"2024-02-10T06:23:21.439Z","dependency_job_id":"e98dabc0-6bb2-4ed4-bbba-735e5ef6519a","html_url":"https://github.com/yusufyusie/budget-app","commit_stats":null,"previous_names":["yusufyusie/budget-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yusufyusie","download_url":"https://codeload.github.com/yusufyusie/budget-app/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241960836,"owners_count":20049342,"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":["devise","postgresql","ruby-on-rails","testing"],"created_at":"2024-11-15T06:28:49.323Z","updated_at":"2026-05-10T05:02:18.218Z","avatar_url":"https://github.com/yusufyusie.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch3 align=\"center\"\u003e\u003cb\u003eSpendSmart\u003c/b\u003e\u003c/h3\u003e\n\n\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n# 📗 Table of Contents\n\n- [📖 About the Project](#about-project)\n  - [🛠 Built With](#built-with)\n    - [Tech Stack](#tech-stack)\n    - [Key Features](#key-features)\n- [💻 Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Setup](#setup)\n  - [Install](#install)\n  - [Usage](#usage)\n  - [Run tests](#run-tests)\n- [👥 Authors](#authors)\n- [🔭 Future Features](#future-features)\n- [🤝 Contributing](#contributing)\n- [⭐️ Show your support](#support)\n- [🙏 Acknowledgements](#acknowledgements)\n- [📝 License](#license)\n\n\n# 📖 SpendSmart \u003ca name=\"about-project\"\u003e\u003c/a\u003e\n\nThe **SpendSmart** keeps track of all your expences associated with catogories. It will allow you to:\n- This name emphasizes the action of spending money wisely\n- create new transactions in order keep track of your expences\n- update/delete existing transactions\n- create new categories in order to classify your expences by categories\n- see the calculated total amount of expences per category\n- update/delete existing categories\n\n\n## 🛠 Built With \u003ca name=\"built-with\"\u003e\u003c/a\u003e\n\n### Tech Stack \u003ca name=\"tech-stack\"\u003e\u003c/a\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eClient\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://developer.mozilla.org/ru/docs/Web/HTML\"\u003eHTML\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://developer.mozilla.org/ru/docs/Web/CSS\"\u003eCSS\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://developer.mozilla.org/ru/docs/Web/JavaScript\"\u003eJavaScript\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eServer\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://www.ruby-lang.org/en/\"\u003eRuby\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://rubyonrails.org/\"\u003eRuby on Rails\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDatabase\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://www.postgresql.org/\"\u003ePostgreSQL\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n\n### Key Features \u003ca name=\"key-features\"\u003e\u003c/a\u003e\n\n- **create/update/delete categories of transactions (expences)**\n- **create/update/delete transactions (expences) associated with a category**\n- **calculate total amount of expences for each category**\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## 🚀 Live Demo \u003ca name=\"live-demo\"\u003e\u003c/a\u003e\n\n- The Live Demo is available [here](https://budget-app-pkds.onrender.com/)\n- The Live vedio is available [here](https://www.loom.com/share/6aaf065b886b417a9cdf7e59d841e766?sid=bd3ccbee-cbad-4409-8996-9a9cee47a511/)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## 💻 Getting Started \u003ca name=\"getting-started\"\u003e\u003c/a\u003e\n\nTo get a local copy up and running, follow these steps.\n\n### Prerequisites\n\nIn order to run this project you need:\n\n- GitHub account;\n- Git installed on your OS;\n- VSCode (or another code editor);\n- modern browser (supporting HTML5 and CSS3) is highly recommended;\n- [Ruby](https://www.ruby-lang.org/en/documentation/installation/) installed;\n- [Ruby on Rails](https://gorails.com/guides) installed;\n- [Node.js and npm](https://nodejs.org/) installed.\n\n### Setup\n\nClone this repository to your desired folder:\n\nLogin to your GitHub account. Clone this repository to your desired folder:\n\n\u003e cd my-folder\n\u003e git clone git@github.com:yusufyusie/budget-app.git\n\nSetup database:\n\u003e sudo -u postgres createuser --interactive --pwprompt\n(provide the username and password described in [config/database.yml](./config/database.yml))\n\n### Install\n\nInstall the dependencies:\n\u003e gem install\n\u003e npm install\n\nCreate database:\n\u003e bin/rails db:create\n\n(OPTIONAL) Fill the database with sample records:\n\u003e bin/rails db:seed\n\n### Usage\n\nTo run the server:\n\u003e rails server\n\nOpen [http://localhost:3000](http://localhost:3000) to view it in your browser.\n\n### Run tests\n\nTo run tests, run the following command:\n\u003e rspec\n\nYou can also check linter errors by running these commands:\n\u003e rubocop\n\u003e npx stylelint \"**/*.{css,scss}\"\n\n(OPTIONAL) For testing the confirmation emails:\n\u003e gem install mailcatcher\n\nOpen [http://localhost:1080](http://localhost:1080) to view it in your browser.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 👥 Authors \u003ca name=\"authors\"\u003e\u003c/a\u003e\n\n👤 **Yesuf Fenta**\n\n- GitHub: [@yusufyusie](https://github.com/yusufyusie)\n- LinkedIn: [in/yusufyusie](https://www.linkedin.com/in/yusufyusie)\n- Twitter: [@yusufyusie](https://twitter.com/yusufyusiee)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 🔭 Future Features \u003ca name=\"future-features\"\u003e\u003c/a\u003e\n\n- [ ] **add transactions/animations**\n- [ ] **add styles for desktop version**\n- [ ] **improve UX/UI design**\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 🤝 Contributing \u003ca name=\"contributing\"\u003e\u003c/a\u003e\n\nContributions, issues, and feature requests are welcome!\n\nFeel free to check the [issues page](../../issues/).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## ⭐️ Show your support \u003ca name=\"support\"\u003e\u003c/a\u003e\n\nIf you like this project just star it!\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 🙏 Acknowledgments \u003ca name=\"acknowledgements\"\u003e\u003c/a\u003e\n\nOriginal design idea by \u003ca target=\"_blank\" href=\"https://www.behance.net/gregoirevella\"\u003eGregoire Vella\u003c/a\u003e\n\nI would like to thank the Microverse program for the knowledge and skills I have acquired in Modules 1-5.\n\nI am grateful to all previous project reviewers for their advice. Thanks to them I could build this app.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 📝 License \u003ca name=\"license\"\u003e\u003c/a\u003e\n\nThis project is [MIT](./LICENSE) licensed.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyusufyusie%2Fbudget-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyusufyusie%2Fbudget-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyusufyusie%2Fbudget-app/lists"}