SoulCred is a revolutionary decentralized platform for issuing and managing Soulbound Tokens (SBTs) that represent your learning achievements and community contributions. Built with cutting-edge Web3 technologies, it provides a secure, transparent, and permanent way to showcase your skills and accomplishments.

• ⚛️ React 18 - Modern React with hooks and concurrent features
• 📘 TypeScript - Full type safety and enhanced developer experience
• 🎨 Tailwind CSS - Utility-first styling with custom design system
• 🔗 Wagmi - React hooks for Ethereum blockchain interaction
• 🌈 RainbowKit - Beautiful wallet connection UI components
• 📊 Recharts - Interactive data visualization components

• 🔐 Ethers.js - Ethereum library for smart contract interaction
• 🌐 IPFS - Decentralized storage via Pinata gateway
• 🦊 MetaMask - Primary wallet integration with multi-wallet support
• 🔗 Multi-Network - Sepolia, Goerli, and Polygon Mumbai testnets

// SoulCredSBT.sol - Soulbound Token Implementation
contract SoulCredSBT is ERC721, ERC721URIStorage, Ownable {
    // ✅ Non-transferable credential tokens
    // ✅ On-chain endorsement system
    // ✅ Recovery mechanisms for lost wallets
    // ✅ Community verification features
}

• 🌐 Modern web browser (Chrome, Firefox, Safari, Edge)
• 🦊 MetaMask or compatible Web3 wallet
• 💰 Test ETH for gas fees (free from faucets)

# 1️⃣ Clone the repository
git clone https://github.com/danielas-tochi/soulcred-dapp.git
cd soulcred-dapp

# 2️⃣ Install dependencies
npm install

# 3️⃣ Set up environment (optional for basic usage)
cp .env.example .env
# Edit .env with your API keys (see Configuration section)

# 4️⃣ Start development server
npm run dev

# 5️⃣ Open in browser
# Navigate to http://localhost:5173

The app works with minimal configuration using public providers. For enhanced features:

# 🌐 Blockchain Providers (choose one)
VITE_ALCHEMY_API_KEY=your_alchemy_api_key_here
VITE_INFURA_API_KEY=your_infura_api_key_here

# 📱 Mobile Wallet Support (optional)
VITE_WALLETCONNECT_PROJECT_ID=your_walletconnect_project_id_here

# 📁 File Upload to IPFS (required for file uploads)
VITE_PINATA_JWT=your_pinata_jwt_here
PINATA_JWT=your_pinata_jwt_here  # For serverless functions

1. 🔗 Connect Repository

   • Fork this repository to your GitHub account
   • Connect your GitHub to Netlify
   • Select the forked repository

2. ⚙️ Configure Environment Variables

   • Go to Site Settings → Environment Variables
   • Add your API keys (see Configuration section)
   • Required: PINATA_JWT for file uploads

3. 🚀 Deploy

   • Push to main branch triggers production deployment
   • Pull requests create preview deployments automatically

# Build for production
npm run build

# Deploy using Netlify CLI
npm install -g netlify-cli
netlify deploy --prod --dir=dist

• ✅ Wallet Connection - MetaMask and injected wallets
• ✅ Responsive Design - Mobile, tablet, and desktop
• ✅ Dark/Light Themes - Theme switching functionality
• ✅ Form Validation - Credential creation forms
• ✅ File Upload - IPFS integration (when configured)
• ✅ Error Handling - Graceful error states
• ✅ Accessibility - Keyboard navigation and screen readers

# 1️⃣ Fork the repository
# 2️⃣ Create a feature branch
git checkout -b feature/amazing-feature

# 3️⃣ Make your changes
# 4️⃣ Commit with descriptive messages
git commit -m 'Add amazing feature'

# 5️⃣ Push to your branch
git push origin feature/amazing-feature

# 6️⃣ Open a Pull Request

• 📘 Use TypeScript for all new code
• 🎨 Follow existing code style and conventions
• ✅ Add tests for new functionality
• 📚 Update documentation as needed
• 🔍 Test thoroughly before submitting

• ✅ Core SBT minting interface
• ✅ IPFS integration for file storage
• ✅ Wallet connection with RainbowKit
• ✅ Responsive UI with themes
• ✅ Netlify deployment with serverless functions

• 🔄 Smart contract deployment to testnets
• 🔄 Real blockchain transaction processing
• 🔄 Advanced endorsement system
• 🔄 Credential verification API

• 📋 Multi-chain deployment (Ethereum, Polygon)
• 📋 DAO governance for platform decisions
• 📋 Mobile app development
• 📋 Enterprise integration solutions

• 🌟 Educational institution partnerships
• 🌟 Employer verification tools
• 🌟 Cross-platform credential portability
• 🌟 AI-powered skill assessment