HerbTrace is a comprehensive blockchain-powered traceability platform designed specifically for the Ayurvedic herb supply chain. It provides end-to-end transparency from herb collection in the Himalayas to retail distribution, ensuring authenticity, quality, and compliance with regulatory standards.
To revolutionize the Ayurvedic herb industry through blockchain technology, ensuring authentic, quality herbs reach consumers while supporting sustainable farming practices and empowering herb collectors.
- Herb Collectors - Record collections with GPS coordinates and quality grading
- Supply Chain Managers - Track shipments and monitor logistics
- Laboratory Personnel - Conduct quality testing and certification
- Regulatory Officers - Ensure compliance and generate reports
- Consumers - Verify product authenticity through QR codes
- Collector Dashboard - Track daily collections, earnings, and blockchain submissions
- Supply Chain Tracking - Monitor herb journey with GPS and temperature sensors
- Laboratory Interface - Manage testing queues and certification workflows
- Regulatory Compliance - Automated compliance monitoring and reporting
- Consumer Verification - Simple QR code scanning for product authentication
- Immutable record of herb journey from collection to retail
- Smart contracts for automated quality verification
- Decentralized storage of certification data
- Real-time blockchain status monitoring
- Transaction hash verification for all records
- GPS Coordinates - Precise collection location tracking
- Temperature Monitoring - Cold chain compliance for sensitive herbs
- Quality Grading - Scientific classification (A+, A, B+, etc.)
- Batch Management - Comprehensive batch tracking system
- Frontend: React 18 with Vite for lightning-fast development
- Styling: Tailwind CSS with custom design system
- State Management: Redux Toolkit for predictable state management
- Routing: React Router v6 for declarative navigation
- Charts: Recharts & D3.js for data visualization
- Icons: Lucide React for consistent iconography
- Animations: Framer Motion for smooth interactions
herbtrace/
├── src/
│ ├── components/
│ │ └── ui/ # Reusable UI components
│ │ ├── GlobalHeader.jsx # Application header
│ │ ├── RoleBasedSidebar.jsx # Dynamic navigation
│ │ └── BlockchainStatusIndicator.jsx
│ ├── pages/
│ │ ├── collector-dashboard/ # Herb collector interface
│ │ ├── supply-chain-tracking-dashboard/ # Logistics tracking
│ │ ├── laboratory-testing-interface/ # Quality testing
│ │ ├── regulatory-compliance-dashboard/ # Compliance monitoring
│ │ ├── consumer-product-verification/ # Public verification
│ │ └── user-registration-login/ # Authentication
│ ├── App.jsx # Main application component
│ ├── Routes.jsx # Application routing configuration
│ └── styles/ # Global styles and themes
├── public/ # Static assets
└── package.json # Dependencies and scripts
- Node.js (v14.x or higher)
- npm or yarn package manager
- Modern web browser with JavaScript enabled
-
Clone the repository
git clone <repository-url> cd herbtrace
-
Install dependencies
npm install # or yarn install -
Set up environment variables
cp .env.example .env # Configure your environment variables -
Start development server
npm start # or yarn start -
Open your browser Navigate to
http://localhost:3000
- Dashboard: Track daily collections and earnings
- New Collections: Record herb collections with location data
- Blockchain Status: Monitor submission status and confirmations
- Weather Widget: Get collection recommendations based on weather
Sample Credentials:
- Username:
collector@herbtrace.com - Default Route:
/collector-dashboard
- Shipment Tracking: Monitor active shipments with GPS
- Timeline View: Visualize herb journey through supply chain
- Temperature Monitoring: Ensure cold chain compliance
- Batch Management: Track and manage herb batches
Default Route: /supply-chain-tracking-dashboard
- Testing Queue: Manage incoming samples for quality testing
- Equipment Status: Monitor laboratory equipment availability
- Certification: Generate and manage quality certificates
- Blockchain Integration: Submit test results to blockchain
Default Route: /laboratory-testing-interface
- Compliance Monitoring: Track regulatory compliance across batches
- Alert Management: Monitor and respond to compliance alerts
- Report Generation: Generate comprehensive compliance reports
- Export Data: Export compliance data for external audits
Default Route: /regulatory-compliance-dashboard
- QR Code Scanning: Verify product authenticity
- Product History: View complete herb journey
- Quality Certificates: Access laboratory test results
- Feedback System: Provide feedback on products
Default Route: /consumer-product-verification
# Start development server
npm start
# Build for production
npm run build
# Preview production build
npm run serve
# Run tests (if configured)
npm testHerbTrace uses a custom design system built on Tailwind CSS:
- Colors: Earth-toned palette reflecting natural herb origins
- Typography: Clean, readable fonts optimized for dashboard interfaces
- Components: Consistent UI components with proper accessibility
- Responsive: Mobile-first design supporting all device sizes
- Animations: Subtle animations enhancing user experience
- Role-Based Access Control (RBAC): Strict access control per user type
- Blockchain Verification: Cryptographic verification of all transactions
- Data Encryption: Sensitive data encrypted at rest and in transit
- Audit Trails: Comprehensive logging of all system actions
- Input Validation: Robust validation preventing malicious inputs
- Collection Volume: Daily, weekly, and monthly herb collection volumes
- Quality Scores: Average quality grades across different herb types
- Supply Chain Efficiency: Time from collection to retail
- Blockchain Confirmations: Transaction success rates and timing
- Regulatory Compliance: Compliance percentage across all batches
- Consumer Verification: QR code scan rates and verification success
HerbTrace promotes sustainable practices:
- Carbon Footprint Tracking: Monitor transportation emissions
- Sustainable Collection: Promote responsible harvesting practices
- Seasonal Reminders: Educate collectors about optimal collection times
- Conservation Alerts: Warn about over-harvesting risks
We welcome contributions to HerbTrace! Please follow these guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Use ESLint and Prettier for code formatting
- Follow React functional component patterns
- Implement proper error handling with optional chaining
- Maintain responsive design principles
This project is proprietary software developed for the Ayurvedic herb traceability industry.
- Herb Collectors: Hardworking collectors in the Himalayan regions
- Ayurvedic Community: Traditional knowledge keepers and practitioners
- Blockchain Community: Open-source tools and protocols
- React Ecosystem: Amazing libraries and tools that power this platform
Built with ❤️ for the Ayurvedic herb community
Ensuring authentic herbs from the Himalayas to your home