MIT License
"MoneyMate App" MoneyMate 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.
MoneyMate 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.
MoneyMate 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.
To see the application working live, you can click on the following link that contains the demo version:
Video presentation of the Project
To get a local copy up and running, follow these steps.
In order to run this project you need:
Clone this repository to your desired folder by using this ποΈ command :
git clone https://github.com/Kidd254/Budget_App.git
Go to the project directory:
cd budget-app
Before to run the program, verify that you have Ruby on Rails installed on your OS running the following command:
rails --version
It 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.
Download and Install Ruby on Rails
Once you have verified that you have Ruby on Rails installed, run the following command to install the necessary gems:
bundle install
Then run the following command to install the necessary Node packages:
npm install
After installing the gems and packages, run the following command to create the database:
rails db:create
Then run the following command to migrate the database:
rails db:migrate
Run the following command inside the project folder to start the application:
rails s
This 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.
To verify that the ruby and CSS code is written without errors and meets good practice standards, run the following command inside the project folder:
rubocop
stylelint "**/*.{css,scss}"
To execute the tests, run the following command inside the project folder:
bundle exec rspec
π€ Lawrence Muema Kioko
Upcoming improvements:
Contributions, issues, and feature requests are welcome!
Feel free to check the issues page.
To 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
If you like this project and know someone who might find it helpful, please share it. Or give it a star βοΈ if you like this project!
The 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.
I 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.
This project is MIT licensed.
The UI design of the webpage is not mine. It is under (Creative Commons License)[https://creativecommons.org/licenses/by-nc/4.0/] licensed.