The Future of Learning is Here - A blockchain-powered quiz platform that rewards perfect scores with verifiable NFT achievement badges on the Cardano blockchain.
LearnFlow is a revolutionary learning platform that combines interactive quizzes with blockchain technology. Users can test their knowledge across various topics and earn unique NFT badges for perfect scores, creating a permanent, verifiable record of their achievements on the Cardano blockchain.
- 📚 Interactive Learning: Carefully crafted quizzes designed to test and reinforce knowledge
- 🏆 NFT Achievement Badges: Perfect scores unlock unique NFT badges minted on Cardano
- 🔗 Blockchain Verified: Achievements permanently recorded and verifiable on-chain
- 🤖 AI-Powered Quiz Generation: Create custom quizzes using Google's Gemini AI
- 📊 Progress Tracking: Ai generated analytics and leaderboards
- 🗳️ Community Voting: Vote on AI-generated quizzes to improve quality
- 📱 Mobile-First Design: Responsive interface that works on all devices
- ⚡ Real-time Updates: Live leaderboards and instant feedback
- React 19 - Modern React with latest features
- TypeScript - Type-safe development
- Vite - Fast build tool and dev server
- Tailwind CSS - Utility-first CSS framework
- Lucide React - Beautiful icons
- Convex - Real-time backend-as-a-service
- Convex Auth - Authentication system
- Real-time Subscriptions - Live data updates
- Cardano - Blockchain platform for NFT minting
- Mesh SDK - Cardano wallet integration
- Lucid Cardano - Cardano transaction building
- Blockfrost API - Cardano blockchain API
- Google Gemini AI - AI-powered quiz generation
- Custom Prompts - Tailored for educational content
learnflow/
├── convex/ # Backend functions and schema
│ ├── schema.ts # Database schema definition
│ ├── auth.ts # Authentication configuration
│ ├── quiz.ts # Quiz-related functions
│ ├── nft.ts # NFT minting functions
│ ├── users.ts # User management
│ ├── voting.ts # Quiz voting system
│ ├── leaderboard.ts # Leaderboard functions
│ ├── analytics.ts # Analytics and tracking
│ └── router.ts # HTTP endpoints
├── src/
│ ├── components/ # React components
│ │ ├── QuizApp.tsx # Main quiz application
│ │ ├── QuizScreen.tsx # Quiz taking interface
│ │ ├── ResultsScreen.tsx # Results and NFT minting
│ │ ├── LeaderboardScreen.tsx # Leaderboard display
│ │ ├── ProfileScreen.tsx # User profile
│ │ ├── AIQuizGeneratorModal.tsx # AI quiz creation
│ │ ├── WalletProvider.tsx # Cardano wallet integration
│ │ └── ...
│ ├── lib/
│ │ └── utils.ts # Utility functions
│ ├── App.tsx # Main application component
│ ├── main.tsx # Application entry point
│ └── index.css # Global styles
├── public/ # Static assets
├── package.json # Dependencies and scripts
└── README.md # This file
- Quiz content, questions, and metadata
- AI generation tracking
- Voting scores and community feedback
- Difficulty levels and categories
- User quiz attempts and scores
- NFT transaction tracking
- Performance metrics
- Learning progress tracking
- Achievement streaks
- Level progression
- Minted NFT records
- Blockchain transaction IDs
- Badge metadata
- Community voting on AI-generated quizzes
- Quality control mechanism
- AI Genarated Multiple Choice Questions: Interactive quiz interface
- Instant Feedback: Immediate results with explanations
- Progress Tracking: Real-time progress indicators
- Difficulty Levels: Beginner to Expert classifications
- Perfect Score Requirement: Only 100% scores earn NFTs
- Cardano Integration: Minted on Cardano blockchain
- Unique Metadata: Each badge contains quiz-specific data
- Wallet Integration: Seamless wallet connection
- Google Gemini Integration: AI-powered content creation
- Custom Topics: Generate quizzes on any subject
- Quality Control: Community voting system
- Automatic Categorization: Smart topic classification
- Leaderboards: Global and category-specific rankings
- Achievement Streaks: Consecutive perfect scores
- Level Progression: Unlock advanced content
- Social Features: Community voting and feedback
- Performance Metrics: Detailed quiz statistics
- Learning Insights: Progress visualization
- NFT Collection: Badge gallery and achievements
- Node.js 18+
- npm or yarn
- Convex account
- Google AI API key (for quiz generation)
- Blockfrost API key (for Cardano integration)
-
Clone the repository
git clone https://github.com/yourusername/learnflow.git cd learnflow -
Install dependencies
npm install
-
Set up Convex
npx convex dev
-
Configure environment variables
In your Convex dashboard, add these environment variables:
GOOGLE_AI_API_KEY=your_gemini_api_key BLOCKFROST_PROJECT_ID=your_blockfrost_project_id BLOCKFROST_API_URL=https://cardano-mainnet.blockfrost.io/api/v0 -
Start the development server
npm run dev
-
Open your browser Navigate to
http://localhost:5173
- Create a Convex account at convex.dev
- Run
npx convex devto initialize your backend - Deploy with
npx convex deploy
- Get a Blockfrost API key from blockfrost.io
- Configure your Cardano network (mainnet/testnet)
- Set up wallet integration for users
- Get a Google AI API key from Google AI Studio
- Configure quiz generation parameters
- Set up content moderation
- Sign Up: Create an account with username/password
- Generate Quizzes: Use AI to create custom content
- Take Quizzes: Choose from available quizzes
- Review Content: Vote on community-generated quizzes
- Manage Content: Organize quizzes by difficulty and topic
- Earn NFTs: Get perfect scores to unlock achievement badges
- Track Progress: Monitor your learning journey
- Connect Wallet: Link your Cardano wallet for NFT rewards
npm run dev # Start development server
npm run lint # Run linting- Connect your GitHub repository to Vercel
- Configure environment variables
- Deploy automatically on push
See the detailed deployment guide in the project documentation.
npm run build # Build for production
npx convex deploy # Deploy backend- Authentication: Secure user authentication with Convex Auth
- Input Validation: Comprehensive input sanitization
- Rate Limiting: API rate limiting to prevent abuse
- Blockchain Security: Immutable achievement records
- Data Privacy: GDPR-compliant data handling
This project is licensed under the Apache License - see the LICENSE file for details.
- Convex - For the amazing real-time backend platform
- Cardano Foundation - For the robust blockchain infrastructure
- Google AI - For the powerful Gemini AI model
- Mesh SDK - For seamless Cardano wallet integration
- Tailwind CSS - For the beautiful, responsive design system