Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sumon766/expenses

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/sumon766/expenses
Owner: sumon766
License: mit
Created: 2023-08-14T10:28:40.000Z (over 1 year ago)
Default Branch: dev
Last Pushed: 2023-10-04T10:09:25.000Z (over 1 year ago)
Last Synced: 2024-10-21T19:38:07.918Z (3 months ago)
Language: Ruby
Size: 134 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        

# 📗 Table of Contents

- [📖 About the Project](#about-project)

  - [🛠 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)

  - [Run tests](#run-tests)

- [👥 Authors](#authors)

- [🔭 Future Features](#future-features)

- [🤝 Contributing](#contributing)

- [⭐️ Show your support](#support)

- [🙏 Acknowledgements](#acknowledgements)

- [📝 License](#license)

# 📖 Expense Recorder 

**Expense Recorder** is a mobile web application that keeps track of one's daily expenses. A user can sign up, sign in and add his daily expenses to keep track of it at the end of the month or may be year. The user can add personalized categories and add transactions to it and view total from each categories.

## 🛠 Built With 

### Tech Stack 

  Framework/Backend

  


    Ruby on Rails

  


Database

  


    PostgreSQL

  


### Key Features 

- **Users can sign up and sign in**

- **Users can add categories and transactions**

- **Users can keep their transactions safely**

(back to top)


## 🚀 Live Demo 

- [Live Demo Link](https://expenses-tracker-8m6v.onrender.com)

- [Presentation Link](https://www.loom.com/share/aefe90bd6a7e42bf967ab737545057e6)

(back to top)


## 💻 Getting Started 

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:

Example command:

```sh

 gem install rails

```

### Setup

Clone this repository to your desired folder:

Example commands:

```sh

  cd my-folder

  git clone [email protected]:sumon766/expenses.git

```

### Install

Install this project with:

Example command:

```sh

  cd my-project

  bundle install

```

### Usage

To run the project, execute the following command:

Example command:

```sh

  rails server

```

### Run tests

To run tests, run the following command:

Example command:

```sh

  rspec

```

(back to top)


## 👥 Authors 

👤 **Mursedul Islam Sumon**

- GitHub: [@githubhandle](https://github.com/sumon766)

- Twitter: [@twitterhandle](https://twitter.com/sumon766)

- LinkedIn: [LinkedIn](https://linkedin.com/in/sumon766)

(back to top)


## 🔭 Future Features 

- [ ] **Users can compare expenses with previous months**

- [ ] **Users can add future expenses in advance and set push notifications**

- [ ] **Users can customize the look & feel of their dashboard**

(back to top)


## 🤝 Contributing 

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](../../issues/).

(back to top)


## ⭐️ Show your support 

If you like this project please feel free to give me a star. And, if this project is useful to you, please feel free to donate for buying me a coffee from my github profile page.

(back to top)


## 🙏 Acknowledgments 

I would like to thank microverse for this excellent idea. Also, special thanks to the author of this design [Gregoire Vella](https://www.behance.net/gregoirevella). His excellent design worked as a motivation to develop this app.

(back to top)


## 📝 License 

This project is [MIT](./LICENSE) licensed.

(back to top)