From d30c70ad14a9f99c1ad95c1de22320603f7f6329 Mon Sep 17 00:00:00 2001 From: cherelemma Date: Sun, 30 Jul 2023 00:05:33 +0300 Subject: [PATCH] create a README for the project --- MIT.md | 10 ++++ README.md | 163 +++++++++++++++++++++++++++++++++++++++++++++++++----- 2 files changed, 160 insertions(+), 13 deletions(-) create mode 100644 MIT.md diff --git a/MIT.md b/MIT.md new file mode 100644 index 0000000..97f904b --- /dev/null +++ b/MIT.md @@ -0,0 +1,10 @@ +## Copyright 2021, [YOUR NAME] + +###### Please delete this line and the next one +###### APP TYPE can be a webpage/website, a web app, a software and so on + +Permission is hereby granted, free of charge, to any person obtaining a copy of this [APP TYPE] and associated documentation files, to deal in the [APP TYPE] without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the [APP TYPE], and to permit persons to whom the [APP TYPE] is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the [APP TYPE]. + +THE [APP TYPE] IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE [APP TYPE] OR THE USE OR OTHER DEALINGS IN THE [APP TYPE]. diff --git a/README.md b/README.md index 7db80e4..9ab660a 100644 --- a/README.md +++ b/README.md @@ -1,24 +1,161 @@ -# README -This README would normally document whatever steps are necessary to get the -application up and running. -Things you may want to cover: + -* Ruby version +
+
-* System dependencies +

Budget Tracker App

+
+
-* Configuration +# 📗 Table of Contents -* Database creation +- [📗 Table of Contents](#-table-of-contents) +- [📖 Budget App](#-budget-app) + - [🛠 Built With ](#-built-with-) + - [Tech Stack ](#tech-stack-) + - [Key Features ](#key-features-) + - [Live Demo](#live-demo) + - [💻 Getting Started ](#-getting-started-) + - [Prerequisites](#prerequisites) + - [Setup](#setup) + - [Install](#install) + - [Usage](#usage) + - [Test](#test) + - [Authors ](#authors-) + - [🔭 Future Features ](#-future-features-) + - [🤝 Contributing ](#-contributing-) + - [⭐️ Show your support ](#️-show-your-support-) + - [🙏 Acknowledgments ](#-acknowledgments-) + - [📝 License ](#-license-) -* Database initialization -* How to run the test suite +# 📖 Budget App -* Services (job queues, cache servers, search engines, etc.) +The Budget App is a web app developed with mobile-first approach that used for efficient budget management. This app allows users to track their expenses by maintaining a list of transactions associated with a category. By utilizing the app, users can easily visualize the amount of money they have spent and on what. -* Deployment instructions +## 🛠 Built With -* ... +### Tech Stack + +
+ Ruby on Rails + + +
+ +### Key Features + +- Record all expenses by creating a category +- List all transactions associated with a category +- All users to visualize how much money they spent on a category + +## Live Demo + +- [Live Demo](https://budget-tracker-pzur.onrender.com/) +- [Project video Link](#) + +

(back to top)

+ +## 💻 Getting Started + +To get a local copy up and running follow these simple example steps. + +### Prerequisites + +In order to run this project you need: + +- Code Editor (Vs Code) or any editor of your choice + +- Terminal + +- Install Ruby on your computer + +- Install Rails on your computer + +### Setup + +Clone this repository by using the command line to your desired folder: + +```sh +git clone https://github.com/Microverse-Fullstack-Program/rails-budget-app + +cd rails-budget-app +``` + +### Install + +Install this project with: + +```sh +cd rails-budget-app + bundle install (install all dependencies) +``` + +### Usage + +To run the project, execute the following command: + +```sh +rails server +``` + +### Test + +```sh + rspec +``` + +

(back to top)

+ +## Authors + +👤 **Chere Lemma** + +- GitHub: [Chere Lemma](https://github.com/cherelemma) +- LinkedIn: [Chere (Urgaya) Lemma](https://www.linkedin.com/in/chere-lemma27211613/) +- Twitter: [@Chere21271613](https://twitter.com/Chere21271613) + + +## 🔭 Future Features + +- [] Implement some UX improvements: like transitions and/or animations, etc. +- [] Create a decent desktop design for the webapp. +- [] Implement the left side menu to improve the navigability of the app. + +

(back to top)

+ + +## 🤝 Contributing + +Contributions, issues, and feature requests are welcome! + +Feel free to check the [issues page](https://github.com/Microverse-Fullstack-Program/rails-budget-app/issues) + + +

(back to top)

+ + +## ⭐️ Show your support + +Leave a star if you like the project. + +

(back to top)

+ +## 🙏 Acknowledgments + +design credits go to: +[@Gregoire Vella](https://www.behance.net/gallery/19759151/Snapscan-iOs-design-and-branding?tracking_source=) - author of design + +

(back to top)

+ +## 📝 License + +This project is [MIT](./LICENSE) licensed. + +

(back to top)