This directory contains step-by-step tutorials and example projects to help you learn and build on PushChain. Each tutorial is designed to demonstrate specific features and capabilities of the PushChain ecosystem.
👉 All Tutorials: Explore the full list on Push.org
A basic introduction to PushChain development with a simple counter application.
What you'll learn:
- Basic PushChain UI Kit integration
- Universal Account connection
- Simple smart contract interaction
- Cross-chain transaction sending
Components:
contracts/- Simple Counter smart contractapp/- Clean React frontend with Push Chain UI Kit
Go to Simple Counter Tutorial →
A comprehensive tutorial demonstrating cross-chain interaction using PushChain's Universal Ethereum Account (UEA) system. This project shows how users from Ethereum, Solana, and PushChain can interact with the same application seamlessly.
What you'll learn:
- Cross-chain user attribution
- Dynamic vs hardcoded chain handling
- Universal Counter contract patterns
- Interactive physics-based UI
- Real-time leaderboard systems
Components:
contracts/- Universal Counter smart contractsapp/- Clean counter display with hardcoded chainsapp-dynamic/- Dynamic chain detection with data tableballsy-app/- Interactive physics-based leaderboard game
Go to Universal Counter Tutorial →
A tutorial demonstrating how to create a cross-chain airdrop system using Universal External Accounts (UEA) and Merkle proofs.
What you'll learn:
- Cross-chain airdrop distribution
- Merkle proof verification
- Universal External Account integration
- Token claiming mechanisms
Components:
contracts/- Universal Airdrop and TestToken contractsscripts/- Deployment and Merkle tree generation scriptsdata/- Airdrop recipient configuration
Go to Universal Airdrop Tutorial →
A tutorial showing how to create a universal ERC-20 token minting system that works across different chains.
What you'll learn:
- Cross-chain token minting
- Universal token standards
- Multi-chain token distribution
- ERC-20 contract patterns
Components:
contracts/- Universal ERC-20 minting contracts
Go to Universal ERC-20 Mint Tutorial →
Each tutorial includes Solidity smart contracts that demonstrate:
- Simple Counter: Basic increment functionality
- Universal Counter: Cross-chain user attribution and counting
- Universal Counter Dynamic: Dynamic chain detection and storage
Clean, minimal interfaces focusing on core functionality:
- Simple wallet connection
- Transaction sending
- Counter display
- Explorer links
Advanced interfaces with dynamic data handling:
- Real-time chain detection
- Data tables with chain information
- Dynamic counter attribution
- Comprehensive chain analytics
Engaging, game-like experiences:
- Matter.js physics engine integration
- Interactive ball animations
- Real-time leaderboards
- Cross-chain competition mechanics
Each tutorial typically includes:
- Smart contracts written in Solidity with deployment scripts
- Frontend applications built with React, TypeScript, and Push Chain UI Kit
- Detailed README files explaining concepts and implementation
- Step-by-step instructions for deployment and usage
- Live demos and deployment configurations
To get started with any tutorial:
- Choose your tutorial based on your learning goals
- Navigate to the tutorial directory of your choice
- Read the README for an overview of the project
- Set up contracts by following the smart contract deployment guide
- Run the frontend by following the app setup instructions
- Experiment and customize the code to make it your own!
Most tutorials assume basic knowledge of:
- Blockchain concepts and Ethereum development
- JavaScript/TypeScript and modern web development
- React and component-based UI development
- Smart contract development with Solidity
- Git and package management (npm/yarn)
If you're new to PushChain development, we recommend following these tutorials in order:
- Simple Counter - Learn the basics of PushChain integration
- Universal Counter (app) - Understand cross-chain user attribution
- Universal Counter (app-dynamic) - Explore dynamic chain detection
- Universal Counter (ballsy-app) - Build interactive, engaging experiences
- Universal Airdrop - Learn cross-chain token distribution with Merkle proofs
- Universal ERC-20 Mint - Explore universal token minting patterns
- Universal Ethereum Accounts (UEAs)
- Chain-agnostic user interfaces
- Cross-chain transaction handling
- Counter contracts with chain attribution
- Dynamic chain detection and storage
- Event emission for real-time updates
- Push Chain UI Kit integration
- Real-time data fetching and updates
- Interactive animations and physics
- Responsive design patterns
- WebSocket event subscriptions
- Matter.js physics integration
- Dynamic data visualization
- Cross-chain leaderboard systems
For more information about PushChain development: