Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fherrerao/budget-app-capstone
A web application where users can create categories with their respective transactions, and see the total amount of each category. Must register before accessing the content.
https://github.com/fherrerao/budget-app-capstone
bootstrap5 rails ruby
Last synced: 4 days ago
JSON representation
A web application where users can create categories with their respective transactions, and see the total amount of each category. Must register before accessing the content.
- Host: GitHub
- URL: https://github.com/fherrerao/budget-app-capstone
- Owner: fherrerao
- License: mit
- Created: 2022-05-23T14:54:17.000Z (over 2 years ago)
- Default Branch: develop
- Last Pushed: 2022-09-08T14:20:09.000Z (over 2 years ago)
- Last Synced: 2025-01-04T06:10:49.195Z (12 days ago)
- Topics: bootstrap5, rails, ruby
- Language: Ruby
- Homepage:
- Size: 1.03 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Recipe App
[](./MIT.md)
## Preview
## Table of Contents
- [Description](#description)
- [Built With](#built-with)
- [Live Demo](#live-demo)
- [Getting Started](#getting-started)
- [Clone Repo](#clone-repo)
- [Prerequisites](#prerequisites)
- [Install Rails](#install-rails)
- [Setup](#setup)
- [System Dependencies](#system-dependencies)
- [Database Initialization](#database-initialization)
- [Usage](#usage)
- [Start Server](#start-server)
- [Testing RSpec](#testing-rspec)
- [How To Contribute?](#how-to-contribute)
- [Collaborators](#collaborators)
- [Show Your Support](#how-your-support)
- [Acknowledgments](#acknowledgments)
- [License](#license)
## Description
> Web application where users can create categories with their respective transactions, and see the total amount of each category. Must registrate before accessing the content.
## Built With
- Major languages: Ruby, HTML, Bootstrap 5.
- Frameworks: Ruby on Rails.
- Tools & Methods: RSpec, Capybara, PostgreSQL, Devise, CanCanCan.
## Live Demo
Check this [Live Demo](https://budget-app.fly.dev/) of the page.
## Getting Started
We'll need to prepare your computer to handle Ruby on Rails, which might be a hassle, so take a deep breath and cope with me :)
If you have Rails 7 installed, you can skip to the [Setup](#setup) section
## Clone Repo
First clone this repo by running this command in your terminal:
~~~ bash
git clone https://github.com/fherrerao/budget-app-capstone.git
# wait a couple seconds for it to download
# ...
# ...
# then move into the new directory
cd budget-app-capstone
~~~
## Prerequisites
The following technologies must be installed before hand in your local machine:
- Ruby (ruby --version). Should be 3.0.1 or newer.
- Postgresql (postgres --version)
- Node.js (node --version)
- Yarn (yarn --version)
The commands in parenthesis `()` can be used to verify if they are installed and their corresponding versions.
Refer to [Section 3](https://guides.rubyonrails.org/v5.1/getting_started.html#:~:text=3%20Creating%20a%20New%20Rails%20Project) from the official [Rails Guide](https://rubyonrails.org/) for more detailed instructions on how to install these technologies.
### Install Rails
Once that's done, we can install Rails. For that, run these commands in your terminal:
~~~ bash
gem install rails
# wait a few seconds for it to download
# ...
# ...
# verify that it was installed by running
rails --version
~~~
## Setup
We're getting there... trust me ;)
## System Dependencies
Execute this command to automatically install all the dependencies needed to view and work on this project:
~~~ bash
bundle install
~~~
The full list of dependencies can be found within the [Gemfile](Gemfile).
This also installs PostgreSQL, which you'll need for the next step.
## Database Initialization
To initialize the database we just created, now run:
~~~ bash
rails db:setup
~~~
## Usage
If you got to this point, congratulations! You now have spent 2 hours in order to toy with my app. I appreciate your effort :P
## Start Server
The following command should start a server
~~~ bash
rails server
~~~
Which you can visit by going to http://localhost:3000 in your browser.
## Testing RSpec
RSpec tests belong in another folder, which is [/spec](/spec/), all thanks to the ruby **magic** called `naming conventions`.
Anyway, to run tests located in the spec folder run:
~~~ bash
bundle exec rspec spec
~~~
## How To Contribute?
Always remember to commit your contributions on a different branch. You can create a new one by running `git checkout -b `.
Visit [linters folder](.github/workflows/linters.yml) to learn how to setup linters.
Then check linters locally before pushing by running:
~~~ bash
npx stylelint "**/*.{css,scss}"
# ...
# ...
rubocop --color -A
~~~
Finally, once your changes have no linter errors and all [tests](#testing-rails) are passing, try to merge your branch into `development` by running:
~~~ bash
git checkout development
git merge
~~~
Continue by solving any merge conflicts that may arise, test the functionality of the app once more, and you're changes are ready to be pushed with `git push origin `
# That's all folks!
## Collaborators
👤 **Fernando Herrera**
Platform | Badge |
--- | --- |
**GitHub** | [@fherrerao](https://github.com/fherrerao)
**Twitter** | [Fernando Herrera](https://www.linkedin.com/in/fherrerao/)
**LinkedIn** | [Fernando Herrera](https://twitter.com/fherrera0206)
## Show your support
Give a ⭐️ if you like this project!
## Acknowledgments
- Original design idea by: [Gregoire Vella on Behance](https://www.behance.net/gregoirevella)
- The ideas and inspiration from this project are coming from this online school of software development:
### [Microverse](https://www.microverse.org/)
## 📝 License
This project is [MIT](./LICENSE) licensed.