{"id":20417979,"url":"https://github.com/yusufyusie/budget_application","last_synced_at":"2026-04-12T03:37:21.462Z","repository":{"id":222181338,"uuid":"756480703","full_name":"yusufyusie/budget_application","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-16T22:17:10.000Z","size":293,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-01-15T14:12:14.659Z","etag":null,"topics":["bootstrap5","devise","postgresql","ruby","ruby-on-rails"],"latest_commit_sha":null,"homepage":"https://spendsmart-hf5z.onrender.com","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-12T18:42:10.000Z","updated_at":"2024-03-11T13:32:16.000Z","dependencies_parsed_at":"2024-02-12T20:25:55.024Z","dependency_job_id":"da7d8909-a513-4a3e-9ff2-da374f155dc7","html_url":"https://github.com/yusufyusie/budget_application","commit_stats":null,"previous_names":["yusufyusie/budget_application"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget_application","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget_application/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget_application/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusufyusie%2Fbudget_application/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yusufyusie","download_url":"https://codeload.github.com/yusufyusie/budget_application/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":["bootstrap5","devise","postgresql","ruby","ruby-on-rails"],"created_at":"2024-11-15T06:28:49.645Z","updated_at":"2026-04-12T03:37:16.429Z","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    \u003cli\u003e\u003ca href=\"https://github.com/heartcombo/devise\"\u003eDevise\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://github.com/CanCanCommunity/cancancan\"\u003eCanCanCan\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://github.com/hotwired/turbo\"\u003eHotwire/Turbo\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://spendsmart-hf5z.onrender.com/)\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-application.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 ensure the quality and reliability of our code, we use a variety of testing tools and linters. Here's how you can run them:\n\n- **Run Tests**: We use RSpec for our tests. To run them, use the following command:\n\n  ```bash\n  rspec\n\nYou can also check linter errors by running these commands:\n\u003e rubocop\n\u003e npx stylelint \"**/*.{css,scss}\"\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\nWe're constantly working to improve and expand the functionality of this project. Here are some features we're planning to implement in the future:\n\n- [ ] **Transaction Animations**: To make the user experience more dynamic and engaging, we're planning to add animations to the transaction process.\n- [ ] **Desktop Version Styles**: We're working on a design overhaul to ensure our application looks great and is easy to use on desktop devices.\n- [ ] **UX/UI Design Improvements**: We're committed to making our application as user-friendly as possible, and we're always looking for ways to improve our UX/UI design.\n\nStay tuned for these exciting updates!\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 🤝 How to Contribute \u003ca name=\"contributing\"\u003e\u003c/a\u003e\n\nWe welcome all contributions and suggestions! Here's how you can help:\n\n- **Report a bug**: If you've found a problem, please let us know through the [issues page](../../issues/).\n- **Suggest a feature**: Have an idea for a new feature? We'd love to hear about it on the [issues page](../../issues/).\n- **Submit a pull request**: If you've fixed a bug or implemented a new feature, we'd be thrilled to review your changes.\n\nRemember, all participants are expected to follow our code of conduct.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## ⭐️ Support me \u003ca name=\"support\"\u003e\u003c/a\u003e\n\nIf you find this project useful, please consider supporting us. Here's how:\n\n- **Star this repository**: It's a simple way to help others discover this project.\n- **Share with your network**: If you know someone who would benefit from this project, please share it.\n- **Contribute**: See the section above on how to contribute.\n\nYour support means a lot to me!\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](https://www.microverse.org/) 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\nSpecial thanks to [Render](https://render.com/) for the deployment platform.\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_application","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyusufyusie%2Fbudget_application","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyusufyusie%2Fbudget_application/lists"}