Smart Contracts

Shardeum Dapp Boilerplate

The Shardeum Dapp Boilerplate is your gateway to developing decentralized applications (Dapps) on the Shardeum blockchain. It provides a comprehensive starting point for learning blockchain fundamentals, participating in hackathons, and experimenting with Shardeum's features.

Why Shardeum Dapp Boilerplate?

This boilerplate is tailored for:

  • ✅ Learning Blockchain Fundamentals
  • ✅ Hackathon Projects
  • ✅ Experimenting with Shardeum's Capabilities

Getting Started

Option 1: Using NPM Library

To quickly set up the Shardeum dApp Boilerplate, you can use our npm library. This will clone the repository, install all dependencies, and create a project named test-project with the boilerplate inside it.

Run the following command in your terminal:

npx create-shardeum-dapp@latest --name test-project

After the process completes, navigate to your new project and start the development server:

cd test-project
npm run dev

Your boilerplate is now ready and running on your local machine!

Option 2: Manual Setup

Alternatively, you can manually set up the boilerplate by cloning the repository and installing the necessary dependencies:

git clone

cd shardeum-dapp-boilerplate

npm install

npm run dev


There are three primary modules in the boilerplate:

  • RPC: This module demonstrates the functionality of a Shardeum RPC. Whether it is reading useful data from the blockchain or sending transactions, RPCs serve as a gateway to the blockchain.
  • NFT Minting: This module demonstrates a basic NFT minting page which lets users mint NFTs for a fixed mint price.
  • DeFi: This module demonstrates the use of Uniswap V2 to swap between two tokens.


  • Header: An easily configurable header with wallet connect functionality along with displaying user address and balance.
  • Pages: Individual pages for demonstrating functionality for 3 major verticals in web3 - RPC, NFT, and DeFi.
  • Smart Contracts: All primary smart contracts used in the application can be found in the 'contracts' directory, and the appropriate scripts in the 'scripts' directory.

Contributing Guidelines

We warmly welcome contributions to the Shardeum Dapp Boilerplate! Whether you're fixing bugs, adding new features, or improving documentation, your help makes a big difference.

On this page