dApp Boilerplate

Full Boilerplate Repository

Want to skip the manual setup? Clone the complete boilerplate with everything pre-configured for Shardeum EVM Testnet:

git clone https://github.com/shardeum/shardeum-dapp-boilerplate.git
cd shardeum-dapp-boilerplate
npm install

Configure Your Environment

cp .env.example .env
# Edit .env and add your PRIVATE_KEY

Deploy Contracts and Run

# Deploy to Shardeum Testnet
npm run deploy:testnet
 
# Start the frontend
npm run dev

What's Included

The boilerplate includes:

• ✅ Pre-configured network settings for Shardeum EVM Testnet (Chain ID: 8119)
• ✅ Enhanced ERC20 token contract with OpenZeppelin security features
• ✅ Wallet connection with MetaMask integration
• ✅ Complete frontend with Vite, React, and TypeScript
• ✅ Smart contract deployment scripts ready to use
• ✅ Comprehensive error handling and input validation
• ✅ Security best practices built-in

Next Steps

After cloning the boilerplate:

1. Deploy your contract: Run npm run deploy:testnet
2. Start the frontend: Run npm run dev
3. Connect your wallet: Use MetaMask to interact with your dApp
4. Customize: Modify the contract and frontend to build your unique dApp

Need Help?

If you encounter any issues or need assistance:

• Join Shardeum Discord: Get community support at discord.com/invite/shardeum
• Documentation: Check the full tutorial for detailed explanations
• GitHub Issues: Report bugs at github.com/shardeum/shardeum-dapp-boilerplate/issues

Security Considerations

For detailed security guidance, see the security section in the full tutorial.

Additional Resources

• Build a Frontend dApp Tutorial - Step-by-step guide
• Shardeum Documentation