kit-t's Car Hire

A full stack Car borrowing Dapp!
View Demo | View Contract

Table of Contents

1. About The Project
   • Functionalities
   • Thought Process
2. Built With
   • Backend
   • Frontend
3. Getting Started
   • Prerequisites
   • Installation
4. Contacts

About the project

This is a submission for StackUp's Hedera Capstone Project Expansion Bounty.

Functionalities

• Merchant can add cars for hire
• Customer can borrow cars
• Customer can return cars
• Merchant can give scores to car borrowers

Added Features

• Merchant can see a list of cars added and filter them by status (Borrowed or Available). This is important for merchant to keep track of all the inventories and their availabilty.

• Merchant can set custom refundable deposit and daily rate for each car added. This allows merchant to set appropriate rates for different model of cars and cater to customers with different budgets and needs.

• Customer can choose how long to borrow a car for.

• Customer can see when to return the car by. This is essential so that they can return the car on time.

Thought process

I started tackling the bounty by braimstorming a list of possible features to add, then wrote down pseudo codes to implement them and estimated efforts needed. Afterwards, I prioritized features that can be implemented indepedently with smallest effort and add them incrementally to deliver the most value.

Built With

Backend

• Hedera Smart Contract Service to power logic e.g. token creation, minting & transger

• Remix IDE for deployment of Solidity smart contract

• Hedera testnet as EVM testnet for the smart contract

Frontend

• React as framework for frontend web app development

• Ethersjs for connecting to user wallet & interacting with the testnet

• Netlify for hosting frontend app

• Hashgraph SDK for interacting with Hedera hashgraph

• Mantine for building beautiful, responsive & accessible components

Getting Started

Prerequisites

• Install Node.js 18
• Hedera account

Installation

1. Clone the repo

git clone https://github.com/teyweikiet/stackup-car-borrowing-bounty.git

Deploying Smart Contract & Creating Topics

1. Checkout latest version of contract deployed here.

2. Refer instructions on Hedera campaign quest 8 to deploy smart contract from Remix IDE

Frontend

1. Go to frontend directory

cd frontend

2. Install NPM packages

npm install

3. Create .env and modify accordingly

cp .env.example .env

Contacts

• Discord: @_kit_t
• X (Formerly Twitter): @teyweikiet