Learn how to build decentralized applications with the Nimiq blockchain using the Web Client
No downloads, no installations - just JavaScript that connects directly to the blockchain!
Interactive Tutorials Web Client Documentation Developer Center
- 🔥 Zero Setup Required: Everything runs in your browser using WebContainer
- 📚 Beginner-Friendly: No prior blockchain experience needed
- 🧪 Hands-On Learning: Try code examples immediately
- 🌐 Real Blockchain Interaction: Connect to the actual Nimiq testnet and mainnet
- ⚡ Interactive Environment: Complete file system with terminal access
By the end of this tutorial, you'll master:
- ✅ Network Connection: Connect to Nimiq and read blockchain data
- ✅ Wallet Management: Create wallets and generate addresses
- ✅ Transaction Handling: Send payments and manage funds
- ✅ Staking Operations: Delegate tokens and earn rewards
- ✅ Advanced Features: Work with HTLCs, cashlinks, and more
- Welcome to Nimiq and blockchain development
- Understanding the Web Client architecture
- Setting up your development environment
- Establishing connection to Nimiq network
- Exploring blockchain data and consensus
- Understanding network synchronization
- Creating and managing wallets
- Requesting testnet funds from faucet
- Signing and sending transactions
- Understanding Proof-of-Stake consensus
- Exploring validator ecosystem
- Implementing staking operations
- Advanced Web Client capabilities
- Best practices and optimization
- Real-world application patterns
- Node.js (v18 or higher)
- pnpm (recommended) or npm
- Modern web browser
# Clone the repository
git clone https://github.com/onmax/nimiq-tutorial.git
cd nimiq-tutorial
# Install dependencies
pnpm install
# Start development server
pnpm dev
# Start development server
pnpm dev
# Build for production
pnpm build
# Preview production build
pnpm preview
# Run linting
pnpm lint
# Fix linting issues
pnpm lint:fix
nimiq-tutorial/
├── src/
│ ├── components/ # Custom UI components
│ ├── content/
│ │ └── tutorial/ # Tutorial content
│ │ ├── 0-introduction/
│ │ ├── 1-connecting-to-network/
│ │ ├── 2-working-with-transactions/
│ │ ├── 3-staking-and-validators/
│ │ └── 4-miscellaneous/
│ └── templates/ # Code templates
├── public/ # Static assets
├── scripts/ # Build scripts
└── dist/ # Production build
- TutorialKit: Interactive tutorial framework
- Astro: Static site generator
- Vue 3: Component framework
- TypeScript: Type-safe JavaScript
- UnoCSS: Atomic CSS engine
- Nimiq Web Client: Blockchain integration
We welcome contributions! Here's how you can help:
- Use the "Feedback & Bugs" button in the tutorial
- Create detailed issues with:
- Steps to reproduce
- Expected vs actual behavior
- Browser and environment details
- Fork the repository
- Create a feature branch:
git checkout -b feature/your-feature
- Make your changes following our coding standards
- Test thoroughly across different browsers
- Submit a pull request with a clear description
When adding or modifying tutorial content:
- Keep it Simple: Use clear, jargon-free language
- Be Progressive: Each step builds on the previous
- Include Examples: Provide working code snippets
- Test Everything: Ensure all examples work correctly
- Add Comments: Explain complex code blocks
This tutorial is designed to help developers:
- Understand blockchain fundamentals without getting lost in complexity
- Build real applications using Nimiq's browser-native approach
- Master Web Client APIs through hands-on practice
- Develop best practices for blockchain development
- Create production-ready decentralized applications
This project is open source and available under the Apache License 2.0.
Ready to build your first blockchain app?
Start the Tutorial →
Made with ❤️ by the Nimiq