oovillagran / myxpenses

This is a mobile web application that allows you to manage your budget, organize your list of daily expenses and take control over your incomes/expenses.

MyXpenses

📗 Table of Contents

• MyXpenses
• 📗 Table of Contents
• 📖 MyXpenses app
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • 🚀 Live Demo & preview
  • 💻 Getting Started
    • Prerequisites
    • Setup
    • Usage
    • Run tests
  • 👥 Authors
  • 🔭 Future Features
  • 🤝 Contributing
  • ⭐️ Show your support
  • 🙏 Acknowledgments
  • 📝 License

📖 MyXpenses app

MyXpenses is a RoR application 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. 💰💸💹🤑🪙💴

🛠 Built With

Tech Stack

• Ruby
• PostgreSQL

Key Features

• Use of Ruby on Rails framework.
• Use Ruby Gems as a software packages system
• Understand what ORM is
• Use database migration files to maintain database schema.
• Understand Rails RESTful design and router.
• Secure app from n+1 problems.
• Use validations for models.
• Set up associations between models.
• Write integration tests with capybara gem.
• Build a webapp that requires the user to log in.
• Deploy a RoR application.

(back to top)

🚀 Live Demo & preview

Here you can see a Live Demo.

Here there is a walkthrough.

💻 Getting Started

Follow these steps in order to run ruby code.

Prerequisites

First, you need to ensure that you have Rails and Ruby installed on your computer.

Setup

It varies depending on your operating system so here are some links to help you install it on Windows and on Ubuntu.

For MacOS run the following commands

  brew install rbenv ruby-build
  # Add rbenv to bash so that it loads every time you open a terminal
  echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
  source ~/.bash_profile

  # Install Ruby
  rbenv install 3.0.1
  rbenv global 3.0.1
  ruby -v

This example shows how to install Ruby 3.0.1 which was the latest version in April 2021, but you can check to see if there is a newer version here. Iy is also assumed that you have homebrew already installed on your Mac.

Usage

Once you have ruby installed, clone this repository

To run the project, execute the following command in the terminal:

bundle install

rails server

In your preferred browser, navigate to:

http://localhost:3000

Run tests

To run tests, run the following command in the terminal:

rspec

👥 Authors

👤 Oscar Villagran

• GitHub: @oovillagran
• Twitter: @oovillagran
• LinkedIn: Oscar Villagran

(back to top)

🔭 Future Features

The following are the future features that will be added to the project.

• Add API endpoints.
• Add images and videos section.
• Add payment options.

(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 you can give us a hand by recommending either one of us to potential employers! 😉🤝

(back to top)

🙏 Acknowledgments

I would like to thank those who have motivated me to keep on fighting despite how tough the journey may become. I would also like to acknowledge Gregoire Vella and the Creative Commons, who are the the designers for the styles of MyXpenses app.

(back to top)

📝 License

This project is MIT licensed.

(back to top)