Skip to content

eigenvalue88/Chainverse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Chainverse

Overview

An educational web application designed to teach blockchain and smart contract fundamentals to beginners through structured learning paths, interactive content, and personalized progress tracking. All content is presented in English with a humorous, concise, and technically accurate tone targeting beginner-to-intermediate blockchain learners.

Authentication

  • Users authenticate using Internet Identity
  • User accounts track individual learning progress and preferences

Core Features

Onboarding Questionnaire

  • Present up to 10 questions during user registration to assess current knowledge level
  • Questions cover blockchain basics, programming experience, and learning preferences
  • Generate customized study plan based on questionnaire responses
  • Store questionnaire answers to inform study plan adaptation
  • Persist onboarding quiz results in localStorage and backend
  • Auto-load previous results on app load, skipping quiz if already completed

Personalized Study Plan

  • Generate customized learning paths based on onboarding questionnaire responses
  • Include timelines and Proof of Progress (PoP) for each learning module
  • Adapt study plan based on quiz performance and user feedback
  • Track completion status and understanding levels for each topic
  • Proof of Progress (PoP) dynamically update based on user's onboarding questionnaire responses
  • All learning modules are accessible from the start without progressive locking
  • All PoP nodes are clickable and unlocked, providing intuitive navigation
  • Ensure PoP labels and nodes are properly aligned with their corresponding modules/topics on the front page

Educational Content

  • Curated list of top-viewed, most relevant YouTube videos for each module (English, high-resolution, non-promotional, non-repetitive) directly teaching the module's theme
  • All videos must be 60 minutes or less in duration and accessible without region restrictions
  • Total video duration per module must not exceed 90 minutes
  • Each video includes title, link, duration, and short description
  • Videos are playable directly within the app with robust fallback player and comprehensive error handling
  • Comprehensive video audit system that validates accessibility, duration, and region restrictions for all module videos
  • Automatic replacement of inaccessible, region-restricted, or overly long videos with next most popular, relevant, and accessible alternatives
  • "Reload" or "report issue" options for problematic video links
  • All video links validated for accessibility, duration compliance, and regional availability before displaying to user
  • Validate that all videos are accessible (not private or region-restricted) and match the module theme
  • Specific video replacements required for broken or inaccessible content:
    • "Cryptocurrency Comparison" module: Replace first and second videos with next most popular and relevant working videos
    • "Ethereum Platform" module: Replace second and third videos with stable, popular, and relevant alternatives
    • "Solidity Basics" module: Replace all three videos with top-viewed, accessible, and relevant videos under 60 minutes
    • "DApp Development" module: Replace first and third videos with shorter, popular, and relevant videos
    • "Security Best Practices" module: Replace last two videos with most liked, accessible, and relevant videos under 60 minutes
    • "Real World Applications" module: Replace last video with most liked, accessible, and relevant video
  • Text-based reading material tailored specifically to each module's topic
  • Interactive exercises designed for each module's specific learning objectives
  • Real-world blockchain application examples and use cases
  • Module comparing major cryptocurrencies (Bitcoin vs. Ethereum) highlighting differences in smart contract support and other key distinctions
  • Every module includes comprehensive reading material and relevant exercises

Assessment System

  • 5 relevant exercise questions generated for each module after the video content
  • Multiple-choice/conceptual questions for beginner modules
  • Coding/analytical questions for intermediate/advanced modules
  • Each question includes correct answers and brief explanations
  • "Redo Quiz" button available for each exercise/quiz with full functionality
  • After submission, display correct answers and detailed explanations
  • Allow users to retry quizzes/exercises anytime with multiple attempts
  • Clear feedback on quiz results with attempt tracking
  • Immediate feedback on quiz results
  • Adaptive questioning based on user performance
  • Progress tracking and performance analytics
  • Quiz page loads correctly and handles answer submission properly

Module Completion System

  • Module completion defined as: video fully watched AND quiz/exercise completed at least once
  • Generate shareable badge for each completed module
  • Track completion status using this logic
  • PoP certificates unlock only after module's video is watched and exercises are completed

Visual Flow Interface

  • Build visual flow using nodes and edges showing relationships between modules
  • Implement using react-flow library or similar
  • All nodes are clickable and accessible without locks
  • PoP section navigation fixed so clicking each module node reliably navigates to correct module content
  • Display module connections and learning pathways
  • Intuitive and meaningful PoP visualization for user navigation

Community Discussion Board

  • Discussion board under each module
  • Comment and reply functionality
  • Upvote system for comments
  • "Report" feature for inappropriate content
  • Users can identify with name or nickname
  • Threaded conversations support

Feedback Integration

  • User feedback forms for content quality and difficulty
  • System adapts study plan based on feedback and quiz results
  • Personalized recommendations for additional topics or review

Progress Visualization

  • Game-like path or journey visualization showing learning advancement
  • Visual elements resembling blockchain path, nodes, or levels to display progress
  • Proof of Progress (PoP) displayed as unlocked, clickable blocks or nodes along the path
  • Intuitive navigation through PoP visualization

New Mascot Integration

  • Replace Labubu mascot with a new, cute character design
  • Add subtle animations: idle bounce, wave, blink
  • Display mascot as guide on homepage and in quiz feedback
  • Integrate mascot throughout the user experience site-wide

Branding Consistency

  • Display "Chainverse" app name prominently and consistently across header, landing page, and all major UI elements
  • Ensure proper branding visibility throughout the application interface
  • App name must be clearly visible in header navigation and main landing page sections

Backend Data Storage

  • User profiles and authentication data
  • Onboarding questionnaire responses with localStorage backup
  • Learning progress and completion status
  • Quiz results and performance metrics including retry attempts and attempt tracking
  • Study plan configurations and timelines
  • Educational content (text, exercises) tailored to each module
  • Curated YouTube video data for each module with metadata (title, link, duration, description)
  • Video validation status including accessibility, region restrictions, and duration compliance
  • Comprehensive video audit results and replacement tracking
  • Module-specific video replacement data for broken or inaccessible content
  • Quiz questions and answer options with detailed explanations
  • Module-specific exercise questions (5 per module) with difficulty-appropriate formats
  • User feedback and ratings
  • Cryptocurrency comparison module content
  • Proof of Progress (PoP) configurations based on questionnaire responses
  • Module completion badges and sharing data
  • Community discussion posts, replies, upvotes, and reports
  • User nicknames and community profiles
  • Visual flow module relationship data
  • Module-specific reading material and exercise content

Backend Operations

  • Process onboarding questionnaire and generate initial study plan
  • Sync onboarding results between localStorage and backend
  • Generate personalized study plans based on user assessment
  • Track and update learning progress with new completion logic
  • Process quiz submissions with enhanced error handling, handle retries with attempt tracking, and calculate scores
  • Adapt study plans based on performance data and questionnaire responses
  • Perform comprehensive video audit for all modules checking accessibility, region restrictions, and duration compliance
  • Execute specific video replacements for identified broken content in modules:
    • Replace broken videos in "Cryptocurrency Comparison", "Ethereum Platform", "Solidity Basics", "DApp Development", "Security Best Practices", and "Real World Applications" modules
  • Automatically replace videos that fail audit criteria with next most popular, relevant, and accessible alternatives
  • Enforce 60-minute maximum duration and accessibility requirements for all videos
  • Validate video stability, quality, and educational relevance before replacement
  • Handle video URL validation, error reporting, and replacement with fallback options
  • Generate 5 module-specific exercise questions with appropriate difficulty levels
  • Store and retrieve user feedback
  • Manage cryptocurrency comparison module content
  • Generate and update Proof of Progress (PoP) based on questionnaire responses with proper unlocking logic
  • Generate and manage shareable completion badges
  • Manage community discussion posts, replies, upvotes, and moderation
  • Store and retrieve visual flow module relationship data
  • Handle content reporting and moderation
  • Manage module-specific reading material and exercise content
  • Track video watch completion and exercise completion for PoP certificate unlocking
  • Ensure proper alignment of PoP elements with their corresponding modules/topics
  • Maintain consistent "Chainverse" branding data across all backend responses

About

Blockchain AI-powered generated tool

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors