Skip to content

Repository files navigation

Web3 Quest

🎮 Gamified Web3 Learning Platform – Learn, Experiment, and Build in a Fun, Interactive Way


❗Problem Statement

Web3 concepts like DAOs, tokenomics, smart contracts, and rollups are often abstract and difficult to grasp for learners. Most learning platforms are either text-heavy or purely theoretical, lacking interactivity and real-world context.

Learners face challenges such as:

  • Understanding the connection between theory and real-world Web3 systems
  • Experimenting safely with system-level consequences
  • Practically building Web3 logic to see outcomes

Web3 Quest solves this by combining gamified learning, interactive experiments, and real-world concept mapping, making Web3 education intuitive, fun, and practical.


🎯Solution

Web3 Quest provides an interactive, gamified environment to teach Web3 concepts through:

  • Progressive game levels
  • Real-world mappings of blockchain systems
  • Scenario experimentation via “What If?” Mode
  • Simplified “Build Mode” experiments for tokenomics, DAOs, and smart contracts

The objective is to bridge the gap between theoretical Web3 knowledge and hands-on experience, empowering learners to understand, experiment, and create.


💡Core Features

  • Games: 17 interactive levels that teach core Web3 concepts step-by-step, making learning structured and engaging.
  • Web3 in the Real World: Each level is connected to real-world applications and systems, bridging theory and practice.
  • What If? Mode: Experiment with pre-defined scenarios like gas spikes, malicious validators, and liquidity drains to understand system consequences.
  • Build Mode: Design and test simplified Web3 systems — DAOs, tokenomics, smart contracts — and observe outcomes through interactive simulations.
  • Progress Tracking: Track level completion, experiments, and mastery. Users can reset progress to replay levels or explore different strategies.
  • Polished UI/UX: Immersive interface with glass cards, mesh backgrounds, smooth animations, and a neon 3D heart in the footer for visual appeal.

🧩How it Helps Users

Benefit Description
Concrete Learning Makes abstract Web3 concepts tangible through interactive gameplay.
System Thinking Visualizes cause and effect, helping users understand system-level consequences.
Hands-On Experimentation Encourages creativity through Build Mode simulations, letting users design and test Web3 systems safely.
Progressive Mastery Users can track progress across levels and experiments, reinforcing structured learning.
Engagement & Fun Gamified elements and interactive animations make learning enjoyable and memorable.

🏗️Architecture

Web3 Quest follows a React SPA architecture with component-based design:

Flow:

  1. User Interaction

    • Plays game levels → triggers local state updates
    • Clicks cards → navigates to Web3 Real World or What If? pages
  2. Data Handling

    • Level info, stories, and scenarios stored in /data/
    • Progress saved in localStorage (level unlocked, XP, Build Mode experiments)
  3. Pages / Features

    • Games: Interactive levels
    • Web3 World: Real-world mapping
    • What If?: System thinking scenarios
    • Build Mode: Simplified Web3 experiments
    • About: Platform info
  4. Routing

    • React Router DOM manages page navigation
    • Dynamic routes for level stories /story/:id
  5. UI / Visuals

    • TailwindCSS + Framer Motion for animations
    • Interactive cards with hover and click effects

📁Project Structure

web3-quest/
├── public/ # Static assets, index.html, etc.
├── src/
│ ├── components/                # Reusable UI and feature components
│ │ ├── ui/                      # Generic UI components (buttons, cards, modals, etc.)
│ │ └── what-if/                  # Components specific to What If? Mode
│ │   └── ScenarioVisuals.tsx
│ │ ├── advancedGaming.tsx
│ │ ├── BlockchainGame.tsx
│ │ ├── cryptocurrencyGame.tsx
│ │ ├── dApps.tsx
│ │ ├── defiGame.tsx
│ │ ├── Footer.tsx
│ │ ├── GameHub.tsx
│ │ ├── governance&DAOsGame.tsx
│ │ ├── HeroSection.tsx
│ │ ├── interoperabilityGame.tsx
│ │ ├── layer2SolutionsGame.tsx
│ │ ├── LevelCard.tsx
│ │ ├── MeshBackground.tsx
│ │ ├── Navbar.tsx
│ │ ├── NavLink.tsx
│ │ ├── nfts&MetaverseGame.tsx
│ │ ├── oracles&DataGame.tsx
│ │ ├── privacy&SecurityGame.tsx
│ │ ├── ProgressDashboard.tsx
│ │ ├── regulatoryComplianceGame.tsx
│ │ ├── scaling&PerformanceGame.tsx
│ │ ├── smartContractsGame.tsx
│ │ ├── tokenomicsGame.tsx
│ │ ├── tokens&Standards.tsx
│ │ └── web3IdentityGame.tsx
│ ├── data/
│ │ └── levelStories.ts          # Level info and real-world story data
│ ├── hooks/
│ │ ├── use-mobile.tsx
│ │ └── use-toast.ts
│ ├── lib/                       # Utility functions / helpers
│ ├── pages/
│ │ ├── About.tsx
│ │ ├── BuildMode.tsx
│ │ ├── comingSoon.tsx
│ │ ├── Index.tsx
│ │ ├── LevelStory.tsx
│ │ ├── NotFound.tsx
│ │ ├── RealWorldStories.tsx
│ │ └── WhatIf.tsx
│ ├── test/                      # Test files
│ ├── App.css
│ ├── App.tsx
│ ├── index.css
│ ├── main.tsx
│ └── vite-env.d.ts
├── .gitignore
├── README.md
├── bun.lockb
├── components.json
├── eslint.config.js
├── index.html
├── package-lock.json
├── package.json
├── postcss.config.js
├── tailwind.config.ts
├── tsconfig.app.json
└── tsconfig.json


🛠️Tech Stack

Layer Technology
Frontend React + TailwindCSS
Animations Framer Motion
Icons Lucide React
Routing React Router DOM
Storage localStorage
Visual Effects / UI MeshBackground, Glass Cards, Interactive Hover Effects

🔮Future Scope

  1. Tiered Learning Pathways (Beginner → Advanced)

    • Games are organized into progressive tiers, like structured courses, allowing users to master foundational concepts before tackling advanced topics.
    • Scalable: New concepts and games can be added to each tier without breaking the flow.
  2. Dynamic Build Mode & Sandbox Experiments

    • Users can design and test more complex Web3 systems (DAOs, tokenomics, smart contracts) in a safe, simulated environment.
    • Scalable: Can eventually integrate real-time blockchain testnets or plug-ins for experimentation.
  3. Social Learning & Community Features

    • Introduce leaderboards, achievements, and collaborative challenges to foster peer learning.
    • Scalable: Enables a global community of learners, creating engagement and healthy competition.
  4. Adaptive Learning & Personalized Dashboard

    • Platform tracks user performance, completed concepts, and experiments, providing a personalized dashboard showing strengths, weaknesses, and recommended next steps.
    • Scalable: Supports AI-driven guidance for millions of users over time, turning Web3 Quest into a smart learning ecosystem.
  5. Extensible Web3 Concept Library

    • Continuously add new modules, games, and experiments as Web3 evolves (DeFi, Layer 2, cross-chain, NFT mechanics).
    • Scalable: Keeps the platform always relevant, acting as a long-term, evolving learning ecosystem.

Releases

Packages

Contributors

Languages