Quickstart

Deploy your first Stacks dApp to testnet in 5 steps

Deploy your first Stacks dApp to testnet in minutes. No Docker required. Contracts run on Hiro testnet infrastructure.

Contents

• Install the CLI
• Scaffold a project
• Get testnet STX
• Deploy to testnet
• Start the frontend
• Connect your wallet

Install the CLI

Requires Clarinet 3.21+.

cargo install stacksdapp
stacksdapp --version
stacksdapp doctor

Or build from source:

git clone https://github.com/scaffold-stack/scaffold-stack.git
cd scaffold-stack
cargo install --path cli

Scaffold a project

stacksdapp new my-app
cd my-app

This creates:

• Clarinet configuration for contracts
• Next.js frontend with wallet integration
• Network settings for testnet, mainnet, and devnet

Get testnet STX

1. Open the Hiro testnet faucet
2. Add your deployer mnemonic to contracts/settings/Testnet.toml:

[accounts.deployer]
mnemonic = "your 24 words here"

Deploy to testnet

stacksdapp deploy --network testnet

Preview without broadcasting:

stacksdapp deploy --network testnet --dry-run

Deploy a single contract:

stacksdapp deploy --network testnet --contract counter

This generates a deployment plan, submits transactions, and writes addresses to frontend/src/generated/deployments.json.

Start the frontend

stacksdapp dev --network testnet

Opens http://localhost:3000. The Debug Contracts panel lists every contract function with typed inputs.

Connect your wallet

Click Connect Wallet and connect Leather or Xverse set to Testnet.

• Public functions open a wallet popup to sign and broadcast
• Read-only functions call the node directly (no wallet needed)

You now have a live Stacks dApp on testnet. Use the debug UI to interact with your contracts.

Next steps

Edit contracts

Modify Clarity contracts and see live updates.

Code generation

Bindings, hooks, watch mode, and ABI cache.

Run tests

Test contracts and frontend.

Local devnet

Docker chain with dev --auto-deploy.