Git Product home page Git Product logo

yusufyusie / budget-app Goto Github PK

View Code? Open in Web Editor NEW
2.0 1.0 0.0 3.04 MB

The SpendSmart app keeps track of all your expences. You can create, edit, delete categories and transactions. Each transaction is associeated with 1 or many categories. Built with RoR.

License: MIT License

Dockerfile 1.66% Ruby 59.88% JavaScript 1.03% HTML 27.19% Batchfile 2.33% Shell 0.26% SCSS 7.66%
devise postgresql ruby-on-rails testing

budget-app's Introduction

SpendSmart

๐Ÿ“— Table of Contents

๐Ÿ“– SpendSmart

The SpendSmart keeps track of all your expences associated with catogories. It will allow you to:

  • This name emphasizes the action of spending money wisely
  • create new transactions in order keep track of your expences
  • update/delete existing transactions
  • create new categories in order to classify your expences by categories
  • see the calculated total amount of expences per category
  • update/delete existing categories

๐Ÿ›  Built With

Tech Stack

Client
Server
Database

Key Features

  • create/update/delete categories of transactions (expences)
  • create/update/delete transactions (expences) associated with a category
  • calculate total amount of expences for each category

(back to top)

๐Ÿš€ Live Demo

  • The Live Demo is available here
  • The Live vedio is available here

(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:

  • GitHub account;
  • Git installed on your OS;
  • VSCode (or another code editor);
  • modern browser (supporting HTML5 and CSS3) is highly recommended;
  • Ruby installed;
  • Ruby on Rails installed;
  • Node.js and npm installed.

Setup

Clone this repository to your desired folder:

Login to your GitHub account. Clone this repository to your desired folder:

cd my-folder git clone [email protected]:yusufyusie/budget-app.git

Setup database:

sudo -u postgres createuser --interactive --pwprompt (provide the username and password described in config/database.yml)

Install

Install the dependencies:

gem install npm install

Create database:

bin/rails db:create

(OPTIONAL) Fill the database with sample records:

bin/rails db:seed

Usage

To run the server:

rails server

Open http://localhost:3000 to view it in your browser.

Run tests

To run tests, run the following command:

rspec

You can also check linter errors by running these commands:

rubocop npx stylelint "**/*.{css,scss}"

(OPTIONAL) For testing the confirmation emails:

gem install mailcatcher

Open http://localhost:1080 to view it in your browser.

(back to top)

๐Ÿ‘ฅ Authors

๐Ÿ‘ค Yesuf Fenta

(back to top)

๐Ÿ”ญ Future Features

  • add transactions/animations
  • add styles for desktop version
  • improve UX/UI design

(back to top)

๐Ÿค Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

โญ๏ธ Show your support

If you like this project just star it!

(back to top)

๐Ÿ™ Acknowledgments

Original design idea by Gregoire Vella

I would like to thank the Microverse program for the knowledge and skills I have acquired in Modules 1-5.

I am grateful to all previous project reviewers for their advice. Thanks to them I could build this app.

(back to top)

๐Ÿ“ License

This project is MIT licensed.

(back to top)

budget-app's People

Contributors

yusufyusie avatar

Stargazers

Kevin Cruz avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.