https://github.com/sergio-usma/budget-app
This is a Ruby on Rails 7 app that helps you manage your expenses efficiently by organizing transactions into categories and providing insightful financial data. Keep track of your spending, create new categories, and add transactions with ease.
https://github.com/sergio-usma/budget-app
expenses-tracker finance-application
Last synced: 11 months ago
JSON representation
This is a Ruby on Rails 7 app that helps you manage your expenses efficiently by organizing transactions into categories and providing insightful financial data. Keep track of your spending, create new categories, and add transactions with ease.
- Host: GitHub
- URL: https://github.com/sergio-usma/budget-app
- Owner: sergio-usma
- License: mit
- Created: 2023-11-30T14:23:35.000Z (over 2 years ago)
- Default Branch: develop
- Last Pushed: 2023-12-02T19:03:02.000Z (over 2 years ago)
- Last Synced: 2025-05-31T20:54:22.974Z (about 1 year ago)
- Topics: expenses-tracker, finance-application
- Language: Ruby
- Homepage: https://budget-app-tlkn.onrender.com/
- Size: 573 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Rails 7 Capstone Project - BudgetApp
## 📗 Table of Contents
- [📖 About the Project](#about-project)
- [🛠 Build With](#build-with)
- [Key Features](#key-features)
- [💻 Live Demo](#live-demo)
- [📱 Screen Captures](#screencaptures)
- [📖 Getting Started](#started)
- [🛠 Setup](#setup)
- [Prerequisites](#prerequisites)
- [Usage](#usage)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgment](#Acknowledgment)
- [📜 License](#license)
This BudgetApp is a Ruby on Rails 7 project that helps you manage your expenses efficiently by organizing transactions into categories and providing insightful financial data. Keep track of your spending, create new categories, and add transactions with ease. The design WAS inspired by the original design idea by Gregoire Vella on Behance, and it is used under the Creative Commons license.
- HTML5
- CSS3
- Boostrap
- Ruby on Rails
- PostgreSQL
- **Users can sign up and log in with mandatory details.**
- **Home page displays categories with names, icons, and total transaction amounts.**
- **Transactions page lists category transactions with amounts and provides an option to add new transactions.**
- **Users can add new categories with names and icons.**
- **New transactions require a name, amount, and at least one category.**
- [Click here](https://budget-app-tlkn.onrender.com/) to see the like demo!
- [Click here](https://www.loom.com/share/7cd85feb2f884628b300696cd9badd49?sid=a36d7e53-7b80-4af0-bdf0-319dbca9cd2f) to see the presentation video!
| Login | Features |
|------------------------------------------------------------------|------------------------------------------------------------------|
| 
| 
|
| 
| 
|
1. **Clone the Project Repository:**
```bash
git clone https://github.com/sergio-usma/budget-app.git
```
2. **Navigate to the Project Folder:**
```bash
cd budget
```
Before you can run BudgetApp, ensure you have the following prerequisites and configurations in place:
- **Ruby**: Verify that Ruby is installed on your machine by running `ruby -v` in your terminal. If not, download and install Ruby from the [official Ruby website](https://www.ruby-lang.org/en/documentation/installation/).
- **Ruby on Rails**: Install the Ruby on Rails framework using the following command if you haven't already:
```bash
gem install rails
```
- **Code Editor**: Use a code editor like Visual Studio Code (VSCode). If you don't have it, download it from the [official website](https://code.visualstudio.com/).
- **Git**: Make sure Git is installed and configured for version control. Download Git from the [official Git website](https://git-scm.com/downloads).
- **PostgreSQL**: Install and properly configure PostgreSQL on your development server. We assumes the use of PostgreSQL as the default database. Download PostgreSQL from the [official PostgreSQL website](https://www.postgresql.org/download/).
- **Ruby on Rails Configuration**: Configure your Ruby on Rails project to use PostgreSQL as the default database.
With these prerequisites and configurations in place, you're ready to set up and run the app.
Follow these steps to use the app:
1. **Open your Terminal:**
Navigate to the directory where the project files are located:
```bash
cd /path/to/your/project/files
```
2. **Start the Rails Server:**
```bash
rails server
```
3. **Access to the App:**
- Open your web browser and go to [http://localhost:3000](http://localhost:3000) to access to the app.
- You can login with the default user:
```bash
username: johndoe@example.com
password: 123456
```
👤 **Sergio Usma**
- GitHub: [@sergio-usma](https://github.com/sergio-usma)
- Twitter: [@VonUsma](https://twitter.com/vonusma)
- LinkedIn: [Sergio Andres Usma](https://www.linkedin.com/in/sergiousma/)
- **Users can edit and delete categories.**
- **Users can edit and delete transactions.**
- **Users can add a description to transactions.**
- **Users can add a date to transactions.**
- **Users can add a note to transactions.**
- **Users can add a photo to transactions.**
Contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](https://github.com/sergio-usma/budget-app/issues) and contribute to the project.
If you like this project, please consider supporting us! Your support helps us to continue developing and improving our project for everyone to enjoy. Whether it's a small donation, sharing the project with your friends, or contributing your skills and expertise, every little bit makes a huge difference. With your support, we can create something truly amazing together. Thank you for being a part of our community and helping us to make a difference!
## 🙏 Acknowledgment
I would like to express my heartfelt gratitude to [Microverse](https://github.com/microverseinc) for providing us with the opportunityto work on this project. and I would like to extend my appreciation to my fellow contributors who have played a significant role in making this project a successful. their dedication and collaboration have been invaluable. I also like to express our deepest gratitude to [Gregoire Vella](https://www.behance.net/gregoirevella) on Behance for her Original design [idea](https://www.behance.net/gallery/19759151/Snapscan-iOs-design-and-branding?tracking_source=).
This project is licensed under the [MIT License](./LICENSE) as required by the original design idea by Gregoire Vella on Behance under the Creative Commons license.