CLI commands

Compact reference for stacksdapp flags and commands

Syntax and flags only. For walkthroughs and layout examples, see the Guides tab.

Contents

• Command overview
• new
• add
• dev
• generate
• deploy
• test, check, clean
• Configuration files

Command overview

stacksdapp --version
stacksdapp doctor              # prerequisite checks (Clarinet 3.21+)

Command	Description
stacksdapp new <name>	Scaffold a new monorepo
stacksdapp init	Adopt an existing Clarinet project (guide)
stacksdapp upgrade	Refresh deps and regenerate bindings (guide)
stacksdapp doctor	Check Rust, Node, Clarinet 3.21+, Docker, git
stacksdapp add <name>	Add a blank Clarity contract
stacksdapp add <name> --template sip010	SIP-010 fungible token
stacksdapp add <name> --template sip009	SIP-009 NFT
stacksdapp generate	Regenerate TypeScript bindings (guide)
stacksdapp generate --watch	Regenerate on .clar changes
stacksdapp test	Contract and frontend tests (guide)
stacksdapp check	Type-check Clarity contracts
stacksdapp clean	Remove generated files and devnet state
stacksdapp dev	Local devnet + frontend + watcher (guide)
stacksdapp dev --auto-deploy	Devnet and deploy once the chain is ready
stacksdapp dev --network testnet	Frontend against testnet
stacksdapp dev --network mainnet	Frontend against mainnet
stacksdapp deploy --network <net>	Deploy contracts (devnet, testnet, mainnet)
stacksdapp deploy --network testnet --contract <name>	Deploy one contract
stacksdapp deploy --network testnet --dry-run	Plan and fee estimate, no broadcast

new

stacksdapp new my-dapp

add

stacksdapp add my-contract
stacksdapp add token --template sip010
stacksdapp add nft --template sip009

Creates contracts/contracts/<name>.clar, updates Clarinet.toml, and regenerates bindings.

dev

stacksdapp dev                         # local Docker devnet
stacksdapp dev --auto-deploy           # deploy when chain is healthy
stacksdapp dev --network testnet
stacksdapp dev --network mainnet

Default with no --network starts local devnet (Docker required).

generate

stacksdapp generate
stacksdapp generate --watch

deploy

stacksdapp deploy --network testnet
stacksdapp deploy --network mainnet
stacksdapp deploy --network devnet
stacksdapp deploy --network testnet --contract counter
stacksdapp deploy --network testnet --dry-run

Flag	Description
--network <network>	testnet, mainnet, or devnet
--contract <name>	Deploy only one contract
--dry-run	Print plan and estimated fee without broadcasting

Guides: testnet · mainnet · local devnet

test, check, clean

stacksdapp test
stacksdapp check
stacksdapp clean

Configuration files

Path	Role
contracts/Clarinet.toml	Contract registry (full scaffold layout)
contracts/settings/Devnet.toml	Local accounts (mnemonic warning shown in CLI)
contracts/settings/Testnet.toml	Deployer mnemonic for testnet
contracts/settings/Mainnet.toml	Deployer mnemonic for mainnet
frontend/.env.local	Auto-managed network config; optional NEXT_PUBLIC_HIRO_API_KEY
contracts/.cache/	Cached ABIs (skip redundant initSimnet)
frontend/src/generated/*	Generated bindings. Do not edit by hand.