Skip to content

๐Ÿš€ BlockAuth โ€“ A secure blockchain-based product authentication system built with React, Node.js, Ethereum & IPFS. ๐Ÿ” Verify, validate, and protect your products with trustless technology. ๐Ÿ›ก๏ธ

Notifications You must be signed in to change notification settings

gitarun009/BlockAuth

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

32 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

BlockAuth

A modern, responsive product authenticity system for electronic devices, currently implemented as a web app with QR-based verification. Blockchain integration is planned for the future.

๐Ÿ”—Live link

http://block-auth.vercel.app

๐Ÿš€ Features

  • Manufacturer Portal: Register products and generate QR codes
  • Retailer Portal: Record sales and buyer information
  • Customer Portal: Verify authenticity and view sale history
  • Modern UI: Clean, professional interface with smooth user experience
  • Responsive: Optimized for all device sizes
  • Planned Blockchain: Future-proof design for decentralized verification

๐Ÿ“Š Current Level

  • Web app built with Vite, React, and TypeScript
  • All data managed within the app (blockchain integration not yet implemented)
  • QR codes generated for each product for customer verification

๐Ÿ”ฎ Future Plans

  • Integrate blockchain (Ethereum) to store product registration, sales, and verification data
  • Use smart contracts for tamper-proof authenticity records
  • Enable decentralized verification for customers

๐Ÿ› ๏ธ Tech Stack

Technology Description
React JavaScript library for building user interfaces
TypeScript Strongly typed programming language for scalable apps
Tailwind CSS Utility-first CSS framework for rapid styling
Vite Fast build tool and development server
Shadcn/ui Accessible UI components
Radix UI Primitives for building design systems
Ethers.js (Planned) Blockchain interaction library
Solidity (Planned) Smart contract language
IPFS (Planned) Decentralized file storage

๐Ÿงฐ Tools & Utilities

Tool Purpose
VS Code Code editing
Git Version control
GitHub Project hosting

๐Ÿ“ฆ Installation

  1. Clone the repository:
git clone <repository-url>
cd blockauth
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open http://localhost:5173 in your browser.

๐Ÿ—๏ธ Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint

๐Ÿ“ Project Structure

src/
โ”œโ”€โ”€ components/     # Reusable UI components
โ”‚   โ”œโ”€โ”€ ui/        # Shadcn/ui panels (Manufacturer, Retailer, Customer)
โ”‚   โ””โ”€โ”€ ...        # Custom components
โ”œโ”€โ”€ hooks/         # Custom React hooks
โ”œโ”€โ”€ lib/           # Utilities (blockchain, QR, etc.)
โ”œโ”€โ”€ pages/         # Main and 404 pages
โ””โ”€โ”€ main.tsx       # Application entry point

๐ŸŽจ Customization

You can customize colors, fonts, and other design tokens in the src/index.css file. Update contract addresses and ABI in src/lib/utils.ts as needed (for blockchain integration).

๐Ÿ“„ License

This project is open source and available under the MIT License.

๐Ÿ‘ค Author

Arun Pratap Singh
LinkedIn
GitHub

About

๐Ÿš€ BlockAuth โ€“ A secure blockchain-based product authentication system built with React, Node.js, Ethereum & IPFS. ๐Ÿ” Verify, validate, and protect your products with trustless technology. ๐Ÿ›ก๏ธ

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published