👷‍♂️ Create Hardhat DApp

The fastest way to initialize a new Hardhat development environment.

Features ⚡️

Zero Configuration — No need to install and configure hardhat plugins manually
Typescript by Default — Provides static typing for both JavaScript and Smart Contract ABI
Extensible — Still a Hardhat environment that can be extended with many awesome plugins

Getting Started 📚

Start by running the command below and replace defi-app with the name of your project.

npx create-hardhat-dapp defi-app

Or using yarn

yarn create hardhat-dapp defi-app

Options 🪛

create-hardhat-dapp comes with the following option:

-p, --provider [{ alchemy | infura }] — Prepare network configurations for connecting to networks using your favorite JSON-RPC provider. Leave it blank for alchemy
--no-install — Prevent installing dependencies at beginning

What Comes Out of the Box 📦

Anything marked with 🏷 is optional

Web3

ethers.js — JavaScript library to interact with Ethereum
hardhat-ethers — Extended version of ethers.js for Hardhat

Test

waffle — Simple smart contract testing library
mocha — Feature-rich JavaScript test framework
chai — Assertion library paired with Mocha

Hardhat Plugins

hardhat-gas-reporter optionally requires an API Key for coinmarketcap to fetch price data

hardhat-etherscan requires an API Key for etherscan to submit smart contract

hardhat-gas-reporter — Mocha reporter that generates gas usage
hardhat-etherscan — Smart Contract verification on Etherscan

Tools / Utilities

Feel free to customize the .prettierrc config file to follow your code style

Typescript — Static Type version of JavaScript
Typechain — 🔌 TypeScript bindings for Ethereum smart contracts
Prettier — Automatic code formatter and comes with the Solidity plugin
Yarn Berry — Fast, reliable, and secure dependency management for JavaScript.

Network Configurations 🏷

Ethereum networks require an API Key for JSON-RPC Provider either Alchemy or Infura

You can generate these configurations using the -p or --provider command, see options

Ethereum — Mainnet, Görli and Rinkeby
Polygon (previously matic) — Mainnet and Mumbai
Smart Chain — Mainnet and Testnet

Future 🌅

scaffold-eth-like interface for quickly testing your smart contract
Intuitive command-line menu prompts
Ability to opt-out and use npm or JavaScript
Initialize with an example template like ERC20 Token, ERC721 NFT, AMM, and Lending Protocol

Feel free to suggest anything 🙏🏻

License

Farrel Darian (farreldarian) MIT

Mentions

Some ways and code adopted from create-next-app

farreldarian/create-hardhat-dapp