create-arc-dapp

Zero-config starter kit for building dApps on Arc with passkey authentication and gasless USDC transactions.

Quick Start

Install globally (recommended)

npm install -g create-arc-dapp

create-arc-dapp my-arc-dapp

Or use npx

npx create-arc-dapp my-arc-dapp

Usage

Interactive Mode

Run without arguments to use the interactive prompts:

npx create-arc-dapp

With Options

# Skip all prompts
npx create-arc-dapp my-app -y

# Skip git initialization
npx create-arc-dapp my-app --no-git

# Skip dependency installation
npx create-arc-dapp my-app --no-install

Options

• -y, --yes - Skip prompts and use defaults
• --no-git - Skip git initialization
• --no-install - Skip dependency installation

What's Included

Each project comes with:

• ✅ Smart contracts written in Solidity (Counter, ActionRouter, Vault)
• ✅ Frontend built with React, Vite, and TypeScript
• ✅ Passkey authentication via Circle Modular Wallet
• ✅ Gasless transactions powered by Circle's paymaster
• ✅ Session keys for batched transactions
• ✅ pnpm workspaces for monorepo management
• ✅ Deployment scripts for Arc Testnet
• ✅ Example pages demonstrating contract interactions

Development

After creating your app:

cd my-arc-dapp

# Configure environment variables
# Edit smart-contract/.env and frontend/.env

# Deploy contracts
pnpm deploy

# Start development server
pnpm dev

How It Works

create-arc-dapp bundles the complete template directly in the npm package. This means:

• ✅ Instant setup - No GitHub downloads, works offline
• ✅ Fast installation - Everything you need is included
• ✅ Reliable - No dependency on external repositories
• ✅ Self-contained - Template is versioned with the package

Requirements

• Node.js >= 18.0.0
• pnpm >= 9.0.0
• Circle Modular Wallet account (get keys from Circle Console)
• Arc Testnet RPC URL

License

MIT