Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
264 changes: 263 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,263 @@
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-wagmi`](https://github.com/wevm/wagmi/tree/main/packages/create-wagmi).
# 🌟 Lumina - Illuminate the Path to Blockchain Mastery

<div align="center">
<img src="/public/Images/heroImage.png" alt="Lumina Hero" width="600" />

**Illuminating the path to Web3 mastery in Africa, one lesson at a time.**

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Next.js](https://img.shields.io/badge/Next.js-14.2-black)](https://nextjs.org/)
[![Blockchain](https://img.shields.io/badge/Platform-Web3-purple)](https://ethereum.org/)
</div>

---

## 🎯 What is Lumina?

Lumina is an **innovative Web3 education platform** designed to democratize blockchain education across Africa and beyond. We're not just another tech tutorial site—we're a movement to empower the next generation of blockchain developers, innovators, and thought leaders.

Born from the passion of student developers who saw the transformative potential of Web3 technology, Lumina bridges the knowledge gap in blockchain education by providing:

- **Interactive, multi-modal learning experiences** (video, audio, text, and visuals)
- **Hands-on practical courses** covering blockchain fundamentals, cryptocurrencies, and wallets
- **Gamified learning with quizzes and progress tracking**
- **Wallet-based authentication** for true Web3 integration
- **A supportive community** of learners and builders

### 🌍 Our Mission

To illuminate the path to Web3 mastery in Africa, one lesson at a time. We believe that blockchain technology has the power to revolutionize industries, create economic opportunities, and drive innovation across the continent. By making quality blockchain education accessible, interactive, and practical, we're empowering students and developers to become active participants in the Web3 revolution.

---

## ✨ What Makes Lumina Different?

### 🎓 Multi-Modal Learning Approach
We understand that everyone learns differently. That's why every lesson in Lumina offers:
- **📹 Video lessons** for visual learners
- **🎧 Audio content** for learning on-the-go
- **📄 Text-based materials** for readers who prefer written content
- **🖼️ Interactive visuals** to illustrate complex concepts
- **📑 Downloadable PDFs** for offline reference

### 🎮 Gamified Learning Experience
Learning blockchain shouldn't be boring! Lumina includes:
- **Interactive quizzes** at the end of each lesson and module
- **Progress tracking** with visual charts and statistics
- **Achievement system** to celebrate your milestones
- **Course completion rewards** (coming soon: crypto rewards!)

### 🔗 True Web3 Integration
Experience Web3 firsthand:
- **Wallet-based authentication** - no passwords, just your crypto wallet
- **On-chain interactions** using Base Sepolia testnet
- **Smart contract integration** for user authentication and progress tracking
- **NFT certificates** for course completions (coming soon)

### 🎯 Practical, Real-World Focus
Our curriculum covers:
- **Blockchain Fundamentals**: Understanding distributed ledgers, consensus mechanisms, nodes, and immutability
- **Cryptocurrencies & Tokens**: From Bitcoin to DeFi, utility tokens to NFTs
- **Wallet Management**: Security, private keys, recovery phrases, and best practices
- **Smart Contracts**: Introduction to programmable blockchain applications
- **DeFi Concepts**: Decentralized finance and its applications

---

## 🚀 Key Features

### For Learners
- ✅ **Self-paced learning** - progress at your own speed
- ✅ **Comprehensive courses** from beginner to advanced concepts
- ✅ **Real-time progress tracking** with productivity charts
- ✅ **Interactive dashboard** showing your learning journey
- ✅ **Personalized learning paths** based on your interests

### Platform Capabilities
- 🔐 **Wallet-based authentication** (RainbowKit, WalletConnect)
- 📊 **Progress analytics** using MongoDB and Prisma
- 🎨 **Beautiful, responsive UI** built with Next.js and Tailwind CSS
- ⚡ **Fast, modern tech stack** for optimal performance
- 🌐 **Cross-chain ready** architecture for future expansion

### Coming Soon
- 💰 **Earn While You Learn** - complete tasks and earn crypto rewards
- 📜 **On-chain Resume** - showcase your skills with verifiable credentials
- 🤝 **Community Features** - forums, Discord integration, and events
- 🏆 **Hackathons & Projects** - collaborate on real-world blockchain projects
- 📰 **Newsletter** - stay updated with the latest Web3 insights

---

## 👥 Who is Lumina For?

### 🎓 Students
- Curious about blockchain but don't know where to start
- Want to build a career in Web3 development
- Need structured, comprehensive learning materials

### 💻 Developers
- Looking to transition into blockchain development
- Want to understand Web3 fundamentals before diving into code
- Seeking practical, hands-on blockchain education

### 🌱 Beginners
- No prior blockchain experience required
- Step-by-step guidance from basics to advanced concepts
- Learn at your own pace with multiple learning formats

### 🌍 African Tech Enthusiasts
- Passionate about being part of the Web3 revolution in Africa
- Want to contribute to blockchain adoption on the continent
- Looking for locally-relevant blockchain education

---

## 🛠️ How Lumina Works

1. **Connect Your Wallet** - Use any Web3 wallet (MetaMask, Coinbase Wallet, WalletConnect)
2. **Choose Your Course** - Start with Blockchain Fundamentals or explore other topics
3. **Learn Your Way** - Pick your preferred format: video, audio, text, or all three
4. **Test Your Knowledge** - Complete quizzes to reinforce learning
5. **Track Your Progress** - Watch your productivity chart grow
6. **Join the Community** - Connect with fellow learners and builders

---

## 🎓 Available Courses

### 1️⃣ Blockchain Fundamentals
Master the core concepts of blockchain technology:
- What is blockchain and how it works
- Types of blockchains (public, private, hybrid)
- Nodes, consensus mechanisms, and network architecture
- Cryptography and security fundamentals
- Real-world blockchain applications

### 2️⃣ Cryptocurrencies & Tokens
Explore the world of digital assets:
- Understanding cryptocurrencies and their purpose
- Different types of tokens (utility, security, governance)
- NFTs and their use cases
- DeFi basics and decentralized exchanges
- Token economics and supply mechanisms

### 3️⃣ Wallets
Learn to safely manage your crypto:
- Types of wallets (hot, cold, hardware, software)
- Public keys vs. private keys
- Securing your wallet with recovery phrases
- Best practices for wallet security
- Choosing the right wallet for your needs

---

## 👨‍💻 Meet the Team

Lumina is built by a passionate team of student developers from Africa:

- **Adzape Solomon** - Frontend Developer & Video Animator [@_chiater99](https://twitter.com/_chiater99)
- **Ndubuisi Tochukwu** - Frontend Developer [@devtochukwu](https://twitter.com/devtochukwu)
- **Ani TheRock** - Smart Contract Developer [@ani_therock](https://twitter.com/ani_therock)
- **Azubike Samie** - Backend Developer [@samieazubike](https://twitter.com/samieazubike)

We're students who believe in the power of blockchain to transform Africa's tech landscape. Our enthusiasm for the Web3 space has birthed Lumina, and we're committed to making blockchain education accessible to everyone.

---

## 🌐 Technology Stack

While Lumina focuses on education, we've built it on a robust, modern tech stack:

**Frontend**: Next.js 14, React, TypeScript, Tailwind CSS
**Blockchain**: Wagmi, Viem, RainbowKit, Coinbase OnchainKit
**Backend**: MongoDB, Prisma ORM, Next.js API Routes
**Authentication**: Wallet-based (Web3 native)
**Smart Contracts**: Base Sepolia testnet
**UI Components**: Radix UI, Recharts for analytics

---

## 🚀 Getting Started

### Prerequisites
- Node.js (v18 or higher)
- A Web3 wallet (MetaMask, Coinbase Wallet, etc.)
- Basic understanding of Web3 concepts (we'll teach you the rest!)

### For Learners
1. Visit the Lumina platform
2. Click "Get Started" and connect your wallet
3. Browse available courses and start learning!

### For Developers
```bash
# Clone the repository
git clone https://github.com/SimpleX-T/Lumina.git

# Install dependencies
npm install

# Set up environment variables
# Create a .env file with your DATABASE_URL and other configs

# Generate Prisma client
npx prisma generate

# Run development server
npm run dev
```

Visit `http://localhost:3000` to see the platform in action.

---

## 🤝 Contributing

We welcome contributions from the community! Whether you're:
- 📝 Improving documentation
- 🐛 Fixing bugs
- ✨ Adding new features
- 🎨 Enhancing the UI/UX
- 📚 Creating educational content

Please feel free to open an issue or submit a pull request.

---

## 📜 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

## 🔗 Connect With Us

- 🌐 Website: [Coming Soon]
- 📧 Email: [Contact Us]
- 🐦 Twitter: Follow our team members for updates
- 💬 Discord: [Coming Soon]
- 📺 YouTube: [Watch our introduction video](https://www.youtube.com/watch?v=qPgYnSY1rLU)

---

## 💡 Our Vision for the Future

Lumina is just getting started. We envision a future where:
- 🌍 Thousands of African developers are building on blockchain
- 💰 Learners earn real crypto rewards for their progress
- 🏆 On-chain credentials verify skills and knowledge
- 🤝 A thriving community collaborates on impactful projects
- 🚀 Africa becomes a global hub for Web3 innovation

**Join us in illuminating the path to Web3 mastery. The future is decentralized, and it starts with education.**

---

<div align="center">

**✨ Illuminate the Path. Learn. Explore. Innovate. ✨**

Made with ❤️ by student developers in Africa

</div>