Skip to content

Traffix empowers citizens to anonymously and securely report reckless driving, earning rewards while contributing to safer roads and making road safety a community-driven mission. Repository of Admin Panel : https://github.com/kichuman28/Traffix-admin-panel

Notifications You must be signed in to change notification settings

kichuman28/Traffix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Getting Started with Traffix!

image

Traffix - Road Safety Reporting DApp

Overview

The Traffix is a decentralized application (DApp) that allows users to report road safety issues anonymously. Built using React and Web3, the application interacts with the blockchain to store reports securely. It uses Metamask for wallet connection and IPFS for image storage, providing a trustless and transparent platform for reporting.

Key Features:

  1. Connect Wallet: Users can connect their Metamask wallet to the app.
  2. Capture Image: Users can take photos of road safety issues directly from their webcam.
  3. Add Details: Provide additional information about the issue via a simple report form.
  4. Submit Report: Submit the report to the blockchain, where it is stored securely and anonymously.
  5. View Reports: View previously submitted reports and track ongoing issues within the community.

Technologies Used:

  • React: For building the user interface.
  • Web3.js: For blockchain interaction and smart contract calls.
  • Metamask: For wallet integration and blockchain authentication.
  • IPFS: For decentralized image storage.
  • Pinata: For IPFS file management.

Screenshots:

1. Connect Wallet:

Users need to connect their Metamask wallet to start using the app. image

2. Capture Image:

Capture an image of the road safety issue using your webcam. image

3. Add Details:

Fill in the details like location and issue description. image

4. Submit Report:

Submit the report to the blockchain securely and anonymously. image

Getting Started

Prerequisites

To run this application locally, you will need:

Installation Steps

  1. Clone the Repository:

    Open your terminal and run the following command to clone the repository:

    git clone https://github.com/kichuman28/ipfs-admin-panel.git
  2. Navigate to the Project Directory:

    cd ipfs-admin-panel
  3. Install Dependencies:

    Run the following command to install the necessary packages:

    npm install
  4. Start the Development Server:

    After the dependencies have been installed, start the local development server by running:

    npm start

    This will launch the app in your browser at http://localhost:3000.

Deployment

To deploy this application on GitHub Pages:

  1. Install gh-pages:

    npm install gh-pages --save-dev
  2. Add the deployment script to package.json:

    "scripts": {
       "predeploy": "npm run build",
       "deploy": "gh-pages -d build"
    }
  3. Deploy to GitHub Pages:

    npm run deploy

How to Use

  1. Connect Metamask Wallet: Open the app and connect your Metamask wallet using the "Connect Wallet" button.
  2. Capture an Image: Use your webcam to capture an image of the issue you want to report.
  3. Add Report Details: Fill in the necessary details, including a description of the issue and location.
  4. Submit Report: Once the image and details are ready, click on the "Submit Report" button to submit the report to the blockchain.
  5. View Existing Reports: You can browse through existing reports submitted by other users.

License

This project is licensed under the MIT License.

Contributions

Contributions are welcome! Feel free to fork this project and submit pull requests.


About

Traffix empowers citizens to anonymously and securely report reckless driving, earning rewards while contributing to safer roads and making road safety a community-driven mission. Repository of Admin Panel : https://github.com/kichuman28/Traffix-admin-panel

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published