CrownKit Developer Framework 🛠️

CrownKit is a developer acceleration CLI and scaffolding engine similar to create-react-app, purpose-built for the ultra-high performance EVM-equivalent Monad blockchain.

It allows developers to bootstrap, compile, test, and deploy decentralized applications on Monad in under 1 minute.

Features

• ⚡ Zero-to-Hero Scaffolding: Get a fully working, standard contract and React frontend setup instantly.
• 📦 Pre-Configured Stack: Pre-configured with Hardhat, Ethers.js, Viem, Wagmi, and Tailwind CSS.
• 🌐 Monad Testnet Ready: Built-in network parameters pointing to Monad's official testnet RPC.
• 🛠️ Developer Diagnostics: Diagnose system, Node.js, and RPC connection state with doctor.
• 🔌 Dynamic Plugins: Inject optional modules like auth or nft into active workspace projects.

Installation

You can install CrownKit globally:

npm install -g crownkit-cli

Or run it directly using npx:

npx crown-init my-dapp

Commands

1. Create a New Project

Bootstrap a new Monad application with step-by-step prompts.

crown-init create [project-name]

Templates Available:

1. Basic dApp: Simple state reader/writer (SimpleStorage.sol).
2. ERC20 Token: Custom mintable/burnable token (MonadToken.sol).
3. NFT Marketplace: ERC721 collection and trading system (MonadNFT.sol + NFTMarketplace.sol).
4. DAO: Membership registration, proposals, voting, and executions (MonadDAO.sol).
5. Escrow: Multi-party buyer, seller, and arbiter contract (MonadEscrow.sol).

2. Compile and Deploy

Compile your Solidity contracts and deploy them directly to the Monad Testnet.

cd my-dapp
# Configure your private key in the generated .env file
npm run deploy

This compiles your Solidity code, targets the Monad Testnet, and automatically exports contract ABIs and addresses to your React frontend configuration, making contract synchronization completely seamless.

3. Environment Diagnostics

Diagnose the health of your local environment configuration, Node version, and Monad RPC connection.

crown-init doctor

4. Initialize Config

Add the standard monad.config.ts and .env.example configurations to an existing repository:

crown-init init

5. Add Module Plugins

Extend your workspace with optional modular features.

crown-init add auth    # Social Web2.5 login portal
crown-init add nft     # NFT ERC721 Solidity contract

6. Generate a Wallet

Generate a new, secure cryptographic wallet and securely inject its private key into your .env file for deployments.

crown-init wallet

7. Compile Contracts

Compile your Solidity smart contracts into ABI artifacts and TypeChain typings without deploying them.

crown-init compile

8. Run Unit Tests

Execute your Hardhat test suite to validate your smart contract logic.

crown-init test

9. Clean Build Cache

Remove compiled artifacts, cache, and typechain definitions to force a fresh build on the next compilation.

crown-init clean

Architecture Overview

Scaffolded projects conform to the following directory structure:

my-monad-dapp/
├── contracts/          # Solidity smart contracts
├── scripts/            # Deployment and export scripts
├── test/               # Smart contract unit tests
├── frontend/           # React + Vite + TS + Tailwind frontend
│   ├── src/
│   │   ├── components/ # ConnectWallet, ContractCard, etc.
│   │   ├── pages/      # Home, Dashboard, Interaction
│   │   └── config/     # Wagmi configuration and exported contract JSONs
│   └── package.json
├── hardhat.config.ts   # Compilation network setup
├── monad.config.ts     # Unified Monad chain configuration
├── .env.example        # Env templates
└── README.md

Monad Testnet Chain Parameters

Every generated project is pre-configured with the following network parameters:

• Network Name: Monad Testnet
• Chain ID: 10143
• RPC URL: https://testnet-rpc.monad.xyz
• Block Explorer: https://testnet.monadexplorer.com
• Currency Symbol: DMON