{"id":21199160,"url":"https://github.com/nitbravoa92/budget-app","last_synced_at":"2025-09-28T13:31:02.510Z","repository":{"id":200609408,"uuid":"705305601","full_name":"NitBravoA92/budget-app","owner":"NitBravoA92","description":"YouPayment is a mobile budget app built with Rails 7 and PostgreSQL. It allows the user to record all their expense transactions and classify them by categories. ","archived":false,"fork":false,"pushed_at":"2023-11-16T05:24:57.000Z","size":334,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-01-13T14:56:18.280Z","etag":null,"topics":["devise","postgresql","ruby-on-rails"],"latest_commit_sha":null,"homepage":"https://budget-app-v4rw.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/NitBravoA92.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":"2023-10-15T16:42:16.000Z","updated_at":"2023-11-19T20:02:13.000Z","dependencies_parsed_at":"2023-11-16T06:27:12.723Z","dependency_job_id":null,"html_url":"https://github.com/NitBravoA92/budget-app","commit_stats":null,"previous_names":["nitbravoa92/budget-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fbudget-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fbudget-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fbudget-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitBravoA92%2Fbudget-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NitBravoA92","download_url":"https://codeload.github.com/NitBravoA92/budget-app/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234524690,"owners_count":18846753,"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"],"created_at":"2024-11-20T19:57:04.953Z","updated_at":"2025-09-28T13:31:02.155Z","avatar_url":"https://github.com/NitBravoA92.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e\u003cb\u003eYouPayment | Ruby on Rails capstone project\u003c/b\u003e\u003c/h1\u003e\n  \u003cimg src=\"app/assets/images/app-logo.png\" width=\"200px\" height=\"200px\"\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\n# 📗 Table of Contents\n\n- [📗 Table of Contents](#-table-of-contents)\n- [YouPayment App ](#youpayment-app-)\n  - [🛠 Built With ](#-built-with-)\n    - [Tech Stack ](#tech-stack-)\n    - [Key Features ](#key-features-)\n    - [🚀 Live Demo ](#-live-demo-)\n  - [🔭 Walk through video ](#-walk-through-video-)\n  - [💻 Getting Started ](#-getting-started-)\n    - [Prerequisites](#prerequisites)\n    - [Setup](#setup)\n    - [Install](#install)\n    - [Usage](#usage)\n    - [Run linters](#run-linters)\n    - [Run tests](#run-tests)\n  - [👥 Authors ](#-authors-)\n  - [🔭 Future Features ](#-future-features-)\n  - [🤝 Contributing ](#-contributing-)\n  - [⭐️ Show your support ](#️-show-your-support-)\n  - [🙏 Acknowledgments ](#-acknowledgments-)\n  - [📝 License ](#-license-)\n\n---\n\n\u003c!-- PROJECT DESCRIPTION --\u003e\n\n# YouPayment App \u003ca name=\"about-project\"\u003e\u003c/a\u003e\n\n**\"YouPayment App\"** YouPayment is a mobile budget app built with Rails 7 and PostgreSQL. It allows the user to record all their expense transactions and classify them by categories. This helps the user to keep effective, private and secure control of all the information on their expenses, and thus be able to make better decisions about money management.\n\n**YouPayment** is easy to use and navigate. Users can create categories (with a name and icon) and payment transactions in minutes by selecting at least one category and entering a description and amount. The app then automatically categorizes expenses and tracks spending over time.\n\n**YouPayment** is the perfect budget app for anyone who wants to take control of their finances. It is easy to use and offers a variety of features to help users manage their budget successfully.\n\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\u003eBackend\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://guides.rubyonrails.org/\"\u003eRuby on Rails (v7.0.8)\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.postgresql.org/docs/\"\u003ePostgreSQL\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eFrontend\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://www.w3schools.com/html/\"\u003eHTML5\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.w3schools.com/css/\"\u003eCSS\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.rubyguides.com/2018/11/ruby-erb-haml-slim/\"\u003eERB template\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n\u003c!-- Features --\u003e\n\n### Key Features \u003ca name=\"key-features\"\u003e\u003c/a\u003e\n\n\u003cul\u003e\n  \u003cli\u003eRuby on Rails framework\u003c/li\u003e\n  \u003cli\u003e\n    Use Linters to check code quality\n    \u003cul\u003e\n      \u003cli\u003eRubocop\u003c/li\u003e\n      \u003cli\u003eStylelint\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/li\u003e\n  \u003cli\u003eMVC architectural/design pattern\u003c/li\u003e\n  \u003cli\u003eData persistent in PostgreSQL\u003c/li\u003e\n  \u003cli\u003eTest the application with rspec and capybara gems\u003c/li\u003e\n  \u003cli\u003eAuthentication system build with devise gem\u003c/li\u003e\n  \u003cli\u003eFollow Microverse's list of best practices\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n### 🚀 Live Demo \u003ca name=\"live-demo\"\u003e\u003c/a\u003e\n\nTo see the application working live, you can click on the following link that contains the demo version:\n\n- [YouPayment App - Live Demo](https://budget-app-v4rw.onrender.com/)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 🔭 Walk through video \u003ca name=\"walk-through-video\"\u003e\u003c/a\u003e\n\n\u003ca href=\"https://drive.google.com/file/d/1KPfffq3RFb_OBnaozjq6VrXX-hGTFtcD/view?usp=sharing\"\u003eVideo presentation of the Project\u003c/a\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- GETTING STARTED --\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\u003cul\u003e\n    \u003cli\u003e\u003cp\u003e**A code editor** like Visual Studio Code (Recommended) or any other of your preference. It is necessary to open the project and add or modify the source code. [You can Download Visual Studio Code here](https://code.visualstudio.com/)\u003c/p\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003cul\u003e\n    \u003cli\u003e\u003cp\u003e**Git:** to manage the project versions of source code. [You can Download Git here](https://git-scm.com/)\u003c/p\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003cul\u003e\n    \u003cli\u003e\u003cp\u003e**Nodejs and NPM:** to install and manage the node packages. [Nodejs and NPM installation guide](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)\n\u003c/p\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\n### Setup\n\nClone this repository to your desired folder by using this 👇️ command :\n\n```\ngit clone https://github.com/NitBravoA92/budget-app.git\n```\n\n### Install\n\nGo to the project directory:\n\n```\n cd budget-app\n```\n\nBefore to run the program, verify that you have Ruby on Rails installed on your OS running the following command:\n\n```\n rails --version\n```\n\nIt should show you the version of ruby on rails ​​installed. If this does not happen and only an error message is displayed, then you should either verify your installation or install Ruby on Rails from scratch.\n\n[Download and Install Ruby on Rails](https://guides.rubyonrails.org/getting_started.html)\n\nOnce you have verified that you have Ruby on Rails installed, run the following command to install the necessary gems:\n\n```\n bundle install\n```\n\nThen run the following command to install the necessary Node packages:\n```\n npm install\n```\n\nAfter installing the gems and packages, run the following command to create the database:\n\n```\n rails db:create\n```\n\nThen run the following command to migrate the database:\n\n```\n rails db:migrate\n```\n\n### Usage\n\nRun the following command inside the project folder to start the application:\n\n```\n rails s\n```\n\nThis will start the application on your local server. You can now open your browser and go to http://localhost:3000/ to see the application running.\n\n### Run linters\n\nTo verify that the ruby and CSS code is written without errors and meets good practice standards, run the following command inside the project folder:\n\n- **ruby linter:**\n```\n rubocop\n```\n\n- **CSS linter:**\n```\n stylelint \"**/*.{css,scss}\"\n```\n\n### Run tests\n\nTo execute the tests, run the following command inside the project folder:\n\n```\n  bundle exec rspec\n```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n\u003c!-- AUTHORS --\u003e\n\n## 👥 Authors \u003ca name=\"authors\"\u003e\u003c/a\u003e\n\n👤 **Nitcelis Bravo**\n\n- GitHub: [Nitcelis Bravo](https://github.com/NitBravoA92)\n- Twitter: [@softwareDevOne](https://twitter.com/softwareDevOne)\n- LinkedIn: [Nitcelis Bravo Alcala](https://www.linkedin.com/in/nitcelis-bravo-alcala-b65340158)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n\u003c!-- FUTURE FEATURES --\u003e\n\n## 🔭 Future Features \u003ca name=\"future-features\"\u003e\u003c/a\u003e\n\nUpcoming improvements:\n\n- [x] Add Forms to create a new category and payment\n- [x] Add the functionality to list categories and payments\n- [x] Add the integration tests using capybara gem\n- [x] Create the CSS styles for the app\n- [x] Deploy the application\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n\u003c!-- CONTRIBUTING --\u003e\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](https://github.com/NitBravoA92/budget-app/issues).\n\nTo do Contributions, please fork this repository, create a new branch and then create a Pull Request from your branch. You can find detailed description of this process in: [A Step by Step Guide to Making Your First GitHub Contribution by Brandon Morelli](https://codeburst.io/a-step-by-step-guide-to-making-your-first-github-contribution-5302260a2940)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n\u003c!-- SUPPORT --\u003e\n\n## ⭐️ Show your support \u003ca name=\"support\"\u003e\u003c/a\u003e\n\nIf you like this project and know someone who might find it helpful, please share it.\nOr give it a **star** ⭐️ if you like this project!\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n\u003c!-- ACKNOWLEDGEMENTS --\u003e\n\n## 🙏 Acknowledgments \u003ca name=\"acknowledgements\"\u003e\u003c/a\u003e\n\nThe UI design of this webapp is not mine. This design was created and belongs to Gregoire Vella. (Here)[https://www.behance.net/gallery/19759151/Snapscan-iOs-design-and-branding?tracking_source=] you can find more information about the original design of this mobile app and you can also see Gregoire Vella's profile (here)[https://www.behance.net/gregoirevella] to know more details about his wonderful work.\n\nI would also like to thank my Microverse teammates for their support. They have supported me a lot in carrying out this project, giving me suggestions, good advice and solving my code doubts.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n\u003c!-- LICENSE --\u003e\n\n## 📝 License \u003ca name=\"license\"\u003e\u003c/a\u003e\n\nThis project is [MIT](./LICENSE) licensed.\n\nThe UI design of the webpage is not mine. It is under (Creative Commons License)[https://creativecommons.org/licenses/by-nc/4.0/] licensed.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitbravoa92%2Fbudget-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnitbravoa92%2Fbudget-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitbravoa92%2Fbudget-app/lists"}