https://github.com/sadaf-daneshgar/budget_app
The Ruby on Rails capstone project is about building a mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what.
https://github.com/sadaf-daneshgar/budget_app
postgresql ruby-rails
Last synced: 7 months ago
JSON representation
The Ruby on Rails capstone project is about building a mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what.
- Host: GitHub
- URL: https://github.com/sadaf-daneshgar/budget_app
- Owner: sadaf-Daneshgar
- License: mit
- Created: 2023-12-22T14:30:12.000Z (about 2 years ago)
- Default Branch: development
- Last Pushed: 2024-01-26T08:31:00.000Z (about 2 years ago)
- Last Synced: 2025-04-09T05:51:14.828Z (10 months ago)
- Topics: postgresql, ruby-rails
- Language: Ruby
- Homepage: https://budget-app-zipl.onrender.com
- Size: 353 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Budget App💰
## 📗 Table of Contents
- [💰 Budget App](#about-project)
- [🛠 Built With](#built-with)
- [Key Features](#key-features)
- [🚀 Live Demo ](#-live-demo-)
- [Future Features](#future-features)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Usage](#usage)
- [👥 Authors](#authors)
- [🤝 Contributing](#contributing)
- [⭐️ Show Your Support](#support)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📜 License](#license)
This is a budget app that allows users to track their expenses and incomes. Users can create, edit, and delete transactions. The app also provides a summary of the user's transactions, including the total balance, total income, and total expenses.
- Ruby on Rails
- Ruby
- HTML
- CSS
- [ ] User can create, edit, and delete transactions.
- [ ] User can view a summary of their transactions, including the total balance, total income, and total expenses.
- [ ] User can view a list of all their transactions, sorted by date.
- ✅ Click [here](https://budget-app-zipl.onrender.com) to see the project
- ✅ Click [here](https://drive.google.com/file/d/1gBibLP7Bis7F4Y52T1bZ00zUceLGL6ti/view?usp=sharing) to see the video presentation.
- [ ] User can view a summary of their transactions, including the total balance, total income, and total expenses.
- [ ] User can view a list of all their transactions, sorted by date.
- [ ] User can view a list of all their transactions, sorted by date.
To get started with the Budget App, follow the instructions below:
1. Clone the project repository:
```bash
git clone https://github.com/sadaf-Daneshgar/budget_app.git
```
2. Navigate to the project folder:
```bash
cd budget_app
```
### Prerequisites
Before you can run the Budget App, make sure you have the following prerequisites and configurations in place:
- **Ruby**: Ensure that Ruby is installed on your machine. You can check if it's installed by running `ruby -v` in your terminal. If it's not installed, you can download and install it from the [official Ruby website](https://www.ruby-lang.org/en/documentation/installation/).
- **Ruby on Rails**: You'll need the Ruby on Rails framework installed. If you don't have it yet, you can install it using the following command:
```
gem install rails
```
- **Code Editor**: You should have a code editor like Visual Studio Code (VSCode) installed. You can download VSCode from the [official website](https://code.visualstudio.com/).
- **Git**: Git is essential for version control. Make sure you have Git installed and configured on your system. You can download Git from the [official Git website](https://git-scm.com/downloads).
- **PostgreSQL**: Ensure that PostgreSQL is installed and properly configured on the server where you are developing the project. This project assumes the use of PostgreSQL as the default database. You can download PostgreSQL from the [official PostgreSQL website](https://www.postgresql.org/download/).
- **Ruby on Rails Configuration**: Make sure your Ruby on Rails project is configured to use PostgreSQL as the default database.
With these prerequisites and configurations in place, you'll be ready to set up and run the Blog App.
### 📖 Usage
Follow these steps to use the Blog App:
Open your terminal.
Navigate to the directory where the project files are located:
Copy code
```bash
cd /path/to/your/project/files
```
Start the Rails server:
Copy code
```bash
rails server
```
Open your web browser and go to http://localhost:3000 to access the Budget App.
👤 **Sadaf Daneshgar**
- 👤 GitHub: [@Sadaf-Daneshgar](https://github.com/sadaf-Daneshgar)
- 👤 Twitter: [@SadafDaneshgar](https://twitter.com/SadafDaneshgar)
- 👤 LinkedIn: [Sadaf Daneshgar](https://www.linkedin.com/in/sadaf-daneshgar-2002saba/)
Contributions, issues, and feature requests are welcome!
Feel free to check the issues [page](https://github.com/sadaf-Daneshgar/budget_app/issues) and contribute to the project.
## ⭐️ Show Your Support
If you like this project, kindly drop a start ⭐️ for the [repository](https://github.com/sadaf-Daneshgar/budget_app);
**I would like to thank the following individuals and organizations for their contribution to this project.**
- I would like to express my heartfelt gratitude to [**Microverse**](https://www.microverse.org/?grsf=mohammad-a-nbtazu) for the invaluable learning experience they have provided.
Original design idea by [Gregoire Vella in Behance](https://www.behance.net/gallery/19759151/Snapscan-iOs-design-and-branding?tracking_source=).