MindChain

Where Mindfulness Meets Blockchain Innovation

🧠 Overview

MindChain is a blockchain-integrated wellness platform that rewards users with Soul Tokens for engaging in mindfulness activities. These tokens can be redeemed for discounts on expert-led workshops, creating a unique incentive system for mental wellbeing.

Built on Ethereum and utilizing PyUSD for stable transactions, MindChain combines modern frontend technologies with blockchain capabilities to deliver a seamless, responsive user experience across all devices.

---

✨ Key Features

🪙 Token Economy

• Earn Soul Tokens: Complete mindfulness activities like guided meditation and concentration exercises
• Token-Based Discounts: Use accumulated Soul Tokens for significant discounts on workshops (up to 2 PYUSD)
• Transaction History: Track all earnings and spending in a comprehensive dashboard

🧘‍♀️ Mindfulness Activities

• Guided Meditation: Focus on breathing with customizable ambient sounds and durations
• Concentration Exercises: Improve focus through interactive activities like color matching
• Automatic Rewards: Receive Soul Tokens upon activity completion

🛍️ Workshop Marketplace

• Curated Workshops: Browse and purchase mindfulness workshops from experts
• Creator Platform: Build and sell your own workshops to the community
• Smart Discounts: Automatically applied based on Soul Token balance

💼 Wallet Integration

• Seamless Connection: Easy wallet connection via MetaMask or other Web3 providers
• Balance Management: Monitor Soul Tokens and PyUSD in real-time
• Secure Transactions: All purchases and rewards safely recorded on the blockchain

---

🖼️ Screenshots

Home Page

Welcoming users with an intuitive interface highlighting key features

Activities Dashboard

Interactive mindfulness exercises that reward users with Soul Tokens

Workshop Marketplace

Browse, purchase, and create workshops with token-based discounts

Wallet Integration

Seamless blockchain wallet connection with token balance display

Transaction History

Comprehensive tracking of all token earnings and expenditures

---

🛠️ Technology Stack

Frontend	Backend	Blockchain
React.js	Node.js	Solidity
Tailwind CSS	Express	PyUSD
Context API	MongoDB	Ethereum

Architecture Highlights

• Responsive Design: Perfect user experience across all device sizes
• State Management: React Context API for efficient wallet state handling
• Internationalization: Support for English and Hindi languages
• Dark/Light Mode: Toggle between themes for comfortable viewing
• Smart Contract Integration: Direct interaction with Ethereum blockchain

---

📦 Project Structure

MindChain/
├── frontend/                # React frontend application
│   ├── src/
│   │   ├── components/      # Reusable UI components
│   │   ├── context/         # React Context providers
│   │   ├── hooks/           # Custom React hooks
│   │   ├── images/          # Static images
│   │   └── pages/           # Application pages
│   └── public/              # Public assets
├── backend/                 # Express server
│   ├── model/               # MongoDB schemas
│   ├── routes/              # API endpoints
│   └── server.js            # Entry point
├── contracts/               # Solidity smart contracts
│   ├── SoulToken.sol        # Token contract
└── README.md                # Project documentation

---

🚀 Getting Started

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• MongoDB
• MetaMask or compatible Web3 wallet

Installation

1. Clone the Repository:

   git clone https://github.com/aditya-gg04/MindChain.git
   cd MindChain

2. Frontend Setup:

   cd frontend
   npm install
   npm start

   Frontend will run on http://localhost:3000

3. Backend Setup:

   cd backend
   npm install
   npm start

   Backend API will be available at http://localhost:8000

4. Connect Wallet:

   • Install MetaMask browser extension
   • Create or import a wallet
   • Connect to the application when prompted

---

🌟 Future Roadmap

• Mobile App: Native applications for iOS and Android
• Expanded Workshop Categories: More specialized mindfulness topics
• Community Features: Social interactions and group activities
• Achievement System: Badges and milestones to track progress
• Advanced Analytics: Personalized insights into mindfulness journey
• Direct Creator Payments: Enhanced monetization for workshop creators

---

👥 Team

Lakshya Agarwal	Aditya Gunjkar	Nachiket Deore
Frontend & Blockchain	Frontend & UI/UX	Smart Contracts
GitHub	GitHub	GitHub

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Be kind to your mind, it will be fine.