📗 Table of Contents
CoinMapper is a user-friendly and intuitive budget management application built with Ruby on Rails. This app is designed to assist you in effortlessly managing your finances, helping you track expenses, map income, and gain control over your financial journey. Start your path to financial success today with CoinMapper.
Client
Server
- LocalHost
Database
-
Expense Tracking: Easily keep track of your expenses by categorizing and recording them within the app. This helps you gain insights into your spending habits and make informed decisions.
-
Budget Creation: Set up budgets for different categories, such as groceries, entertainment, utilities, and more. Stay within your budget limits and monitor your spending in real-time.
-
User-Friendly Interface: CoinMapper is designed with simplicity in mind. The intuitive interface ensures that users of all levels can navigate and utilize the app without any hassle.
-
Customizable Categories: Tailor expense categories to suit your unique spending patterns. Create, edit, or delete categories to match your preferences.
-
Secure Authentication: Your financial information is kept safe with robust user authentication and data encryption measures.
-
Check out the live demo of Coin Mapper: CoinMapper Demo
-
To get a visual overview of Coin Mapper and its features, watch our video presentation: CoinMapper Video Presentation
In the video, we provide a walkthrough of the application, demonstrating how to create Categories and Expenses, modify them as you see fit and navigate the responsive design on different devices.
To get a local copy up and running, follow these steps.
Ensure you have Ruby installed on your system. You can check by running the code below in your terminal.
ruby --versionClone or download the Coin Mapper repository to your local machine.
git clone https://github.com/christianonoh/coin-mapper.gitOpen your terminal and navigate to the cloned project directory.
- This project does not require additional dependencies, just Ruby interpreter. However, it uses RuboCop as a linter and you should set it up as well.
bundle install- Database Setup: Navigate to the project directory and set up the database.
rails db:create
rails db:migrate- Start the Rails server to run the application locally.
rails serverOpen your web browser and go to http://localhost:3000 to access CoinMapper.
CoinMapper uses RSpec for testing. To run the tests, follow these steps:
-
Navigate to Project Directory: Make sure you are in the project directory (
coin-mapper). -
Run Tests: Use the following command to run the tests.
rspec- This will execute all the tests in the
specdirectory and provide you with the results.
👤 Christian Onoh
- GitHub: @christianonoh
- Twitter: @onohchristian
- LinkedIn: Christian Onoh
- Visual Reports: Gain deep insights into your financial health with visual reports and graphs. Monitor trends, identify opportunities for saving, and make informed decisions.
- Income Mapping: Keep a clear record of your income sources. Whether it's your salary, freelancing gigs, or passive income, CoinMapper helps you visualize and manage your earnings.
We're committed to continuously improving CoinMapper. If you encounter any issues or have suggestions for improvement, please submit an issue.
If you enjoy using CoinMapper, please consider supporting us to help keep the app free and accessible for everyone. Thanks for your support!
Original design idea by Gregoire Vella.
This project is MIT licensed.