Skip to content

tjw74/clarionedu

Repository files navigation

ClarionEDU - Bitcoin Education Platform

The world's most comprehensive Bitcoin education platform. Learn from first principles: understand the problem, master the solution.

🎯 Mission

To empower individuals worldwide with deep, practical Bitcoin knowledge that enables them to understand, use, and contribute to the Bitcoin ecosystem with confidence and sovereignty.

🚀 Features

Progressive Learning Curriculum

  • Section 1: The Problem - Fiat debasement, Austrian economics, hard money principles
  • Section 2: What is Bitcoin? - Core properties, sovereignty, permissionless nature
  • Section 3: Using Bitcoin - Wallets, keys, entropy, security practices
  • Section 4: Network & Protocol - Nodes, mining, proof of work
  • Section 5: Advanced Technical - Cryptography, Lightning, privacy
  • Section 6: Development - Contributing to Bitcoin's ecosystem

Interactive Learning Experience

  • 📚 Comprehensive lesson content with real-world examples
  • 🧠 Interactive quizzes with detailed explanations
  • 📊 Progress tracking and achievement system
  • 🎯 Practical exercises and hands-on learning
  • 🏆 Gamified learning with badges and milestones

Modern UX/UI

  • 🌙 Always dark mode with sleek, minimal design
  • 📱 Fully responsive across all devices
  • ⚡ Fast, optimized Next.js application
  • 🎨 Beautiful shadcn/ui components
  • 🔥 Smooth animations and transitions

🛠️ Technology Stack

  • Framework: Next.js 15 with App Router
  • Language: TypeScript
  • Styling: Tailwind CSS + shadcn/ui
  • Icons: Lucide React
  • Deployment: Vercel

🏃‍♂️ Getting Started

Prerequisites

  • Node.js 18.0 or later
  • npm or yarn package manager

Installation

  1. Clone the repository:
git clone https://github.com/your-org/clarionedu.git
cd clarionedu
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 to view the application.

📚 Educational Philosophy

First Principles Approach

We start with fundamental questions: What is money? Why does it exist? This foundation makes everything else clear.

Progressive Complexity

Each lesson builds upon the previous. No concept is introduced without proper context and preparation.

Practical Application

Theory without practice is incomplete. Every concept comes with real-world applications and exercises.

Open Source Philosophy

Knowledge should be free and accessible. Our content embraces Bitcoin's open-source ethos.

🎓 Curriculum Overview

Beginner Level (Sections 1-3)

  • Understanding monetary history and fiat problems
  • Bitcoin's core value propositions
  • Practical Bitcoin usage and security

Intermediate Level (Section 4)

  • Bitcoin network mechanics
  • Mining and consensus
  • Protocol fundamentals

Advanced Level (Section 5)

  • Cryptographic foundations
  • Privacy techniques
  • Layer 2 solutions

Expert Level (Section 6)

  • Bitcoin Core development
  • Contributing to the ecosystem
  • Research and innovation

🤝 Contributing

We welcome contributions from the Bitcoin community! Here's how you can help:

Content Contributions

  • Submit lesson improvements
  • Add new educational content
  • Translate lessons to other languages
  • Review and fact-check existing content

Technical Contributions

  • Bug fixes and improvements
  • New features and functionality
  • Performance optimizations
  • Testing and QA

Getting Started with Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit: git commit -m 'Add some feature'
  4. Push to the branch: git push origin feature/your-feature-name
  5. Submit a pull request

📊 Project Structure

clarionedu/
├── src/
│   ├── app/                 # Next.js App Router pages
│   │   ├── learn/          # Learning sections and lessons
│   │   ├── progress/       # Progress tracking page
│   │   ├── about/          # About page
│   │   └── page.tsx        # Home page
│   ├── components/         # React components
│   │   ├── ui/            # shadcn/ui components
│   │   └── education/     # Custom education components
│   └── lib/               # Utilities and content
│       └── content/       # Curriculum content
├── public/                # Static assets
└── README.md             # This file

🌟 Key Learning Outcomes

After completing ClarionEDU, students will be able to:

  • Understand why Bitcoin exists and the problems it solves
  • Explain Bitcoin's technical architecture and properties
  • Use Bitcoin safely and securely for transactions
  • Operate Bitcoin nodes and understand network mechanics
  • Analyze Bitcoin's cryptographic foundations
  • Contribute to Bitcoin's open-source ecosystem

📈 Performance & Analytics

  • ⚡ 95+ Lighthouse performance score
  • 📱 Mobile-first responsive design
  • 🔍 SEO optimized for educational content
  • 📊 Built-in progress tracking
  • 🎯 High completion rates through gamification

🔐 Security Considerations

  • No user data collection beyond progress tracking
  • Local storage for progress (privacy-first)
  • No financial transactions or wallet integrations
  • Educational content only - no investment advice

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

  • Bitcoin Core developers for their tireless work
  • Austrian economists for providing the theoretical foundation
  • The global Bitcoin education community
  • Open source contributors who make projects like this possible

📞 Contact & Community


Start your Bitcoin education journey today. The future of money is here. 🚀

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages