Skip to content

J0SAL/Decentralized-Expense-Tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌌 Tracking Expenses Securely!

License: MIT Open Source Love


Jarvis is A web application backed by the power of Decentralization! The motive of the application is to assist the user in managing and maintaining his/her transactions. A transaction can be either in the form of income or expense. This application provides visualizations in the form of graphs giving users the ability to track by visualizing his/her expenses over a period of time. The application provides the functionality to export transactions in an Excel file. The user can also add transactions through voice commands with a simple click of a button. In addition, all data that the user generates is stored on the blockchain in a decentralized manner powered by Ethereum, which prevents the risks of illegal tampering with the data.

❄️ Features:

  • Data Security
  • Graphical Visualization
  • Top Diversifications
  • Exporting Data to Excel
  • Voice Recognition

❄️ Demo

πŸ› οΈ Technology Stack

  • Website TypeScript Next JS React Bootstrap Chart.js

  • Backend Solidity Ethereum HardhatΒ 

  • Hosting FleekΒ  Goerli EtherscanΒ  AlchemyΒ 

❄️ ScreenShots

  1. Overview

  • Input form
  • Current Balance and Transaction Overview
  • drawing
  1. Transactions

  • List of Transaction sorted by date
  • Download Transaction Option
  • Graphical Analysis of Incomes & Expenses
  • drawing
  1. Performance

  • Line Graph for analyzing transactions throughout the year
  • drawing
  1. Diversification

  • Graphical Analysis of Top Incomes and Expenses
  • drawing

πŸƒ Local setup - Frontend

Before starting 🏁, you need to have Git and Node installed.

# Clone this repository
$ git clone https://github.com/J0SAL/Decentralized-Expense-Tracker.git
# Go into the repository
$ cd Decentralized-Expense-Tracker
$ cd frontend
# Install Dependencies
$ npm install
# Run Application
$ npm run dev
# The server will start at <http://localhost:3000>

πŸƒ Local setup - Backend

Before starting 🏁, you need to have Git and Node installed.

# Clone this repository
$ git clone https://github.com/J0SAL/Decentralized-Expense-Tracker
# Go into the repository
$ cd Decentralized-Expense-Tracker
$ cd backend
# Install dependencies
yarn
# Code Compile
yarn hardhat compile
# testing (optional)
yarn hardhat test
# Run the nodes (*terminal-1*)
yarn hardhat node
# Deploy contract to localhost (*terminal-2*)
yarn hardhat deploy --network localhost

To run this project, you must add the following environment variables to your .env file inside your backend folder.

Environment Variables
GOERLI_RPC_URL=<ALCHEMY_URL> # (https://www.alchemy.com/)

PRIVATE_KEY=<YOUR_ACCOUNT_PRIVATE_KEY> # (https://www.alchemy.com/)

ETHERSCAN_API_KEY=<YOUR_KEY> # (https://goerli.etherscan.io/)

UPDATE_FRONT_END=true # (true: dynamically update ABI and contract address frontend)

🀠 Contributors