Quickstart

Create a new project

The fastest way to start is with a template:

w3m new my-token --template token-standard

Available templates:

The template prompts for parameters (token name, symbol, initial supply, etc.), then scaffolds the full project with contracts, tests, deployment scripts, and a Next.js frontend.

After scaffolding, you see an honest summary of what succeeded:

┌  my-token is ready ─────────────────────────────────╮
│                                                      │
│  ✓ 28 files generated                                │
│  ✓ Dependencies installed                            │
│  ✓ Solidity deps installed                           │
│  ✓ Codegen complete                                  │
│                                                      │
├──────────────────────────────────────────────────────╯

Start the dev environment

For token projects (which include a frontend), select Start dev environment from the post-scaffold menu, or run:

cd my-token
w3m dev

This single command:

1. Starts a local Anvil chain on http://127.0.0.1:8545
2. Compiles contracts with forge build
3. Deploys contracts to the local chain
4. Runs codegen to generate TypeScript bindings
5. Starts the Next.js dev server at http://localhost:3000

Press Ctrl+C to stop everything.

Use the interactive workspace

w3m

Running w3m with no arguments opens the interactive workspace. Inside a project directory, it shows the project menu:

The workspace stays open in a loop — commands run inline and return to the menu.

Run tests

w3m test

Runs forge test on your Solidity contracts. Use --verbose for detailed output.

Deploy locally from the workspace

From the workspace menu, select Deploy > Local (Anvil). This starts Anvil, builds, deploys, and shows a deployment summary — no authentication required.

Deploy to a testnet (requires auth)

When you’re ready to deploy to a live network:

w3m deploy --chain sepolia

Before deploying, set the required environment variables in a .env file:

SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY
DEPLOYER_PRIVATE_KEY=0xYOUR_PRIVATE_KEY

And authenticate:

w3m auth wm_sk_live_your_key_here

Additional deploy options:

w3m deploy --chain sepolia --verify          # Verify contracts on Etherscan
w3m deploy --chain sepolia --vercel          # Deploy frontend to Vercel
w3m deploy --chain sepolia --skip-tests      # Skip test suite