Learn Me a Lightning ⚡

An educational resource explaining the Lightning Network — Bitcoin's layer-2 for instant, cheap payments.

Live Site

learnmealightning.com

About

Learn Me a Lightning is an open-source educational project inspired by Learn Me a Bitcoin. It aims to make the Lightning Network accessible to everyone through:

• Clear explanations that build intuition first
• Interactive tools for hands-on learning
• Visual diagrams to illustrate concepts
• Progressive difficulty from beginner to technical

Tech Stack

• Framework: Astro - Content-first, islands architecture
• Styling: Tailwind CSS
• Cryptography: @noble/secp256k1
• Deployment: Static site (self-hosted)

Getting Started

# Clone the repository
git clone https://git.mutatrum.com/mutatrum/learnmealightning.com.git
cd learnmealightning.com

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Project Structure

learn-me-a-lightning/
├── src/
│   ├── pages/           # All pages
│   │   ├── beginners/   # Beginners section
│   │   ├── technical/   # Technical deep dives
│   │   ├── tools/       # Interactive tools
│   │   └── explorer/    # Network explorer
│   ├── components/      # Reusable components
│   ├── layouts/         # Page layouts
│   └── styles/          # Global styles
├── public/              # Static assets
├── plans/               # Planning documents
└── dist/                # Build output

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ways to Contribute

• Write or improve educational content
• Build interactive tools
• Fix bugs or improve UI/UX
• Translate content (planned)

Acknowledgments

• Learn Me a Bitcoin - Inspiration and Bitcoin basics
• BOLT Specifications - Lightning protocol specs
• Noble Crypto - Excellent cryptographic libraries
• @otaliptus - Original creator of the interactive PSBT Playground

License

MIT License - See LICENSE for details.

Support

If you find this project helpful, consider supporting its development:

• Lightning: donate@learnmealightning.com
• Donate Page

---

Built with ❤️ for the Lightning Network community