Quickstart

Deploy your first Stacks dApp to testnet in 5 steps with stacksdapp — install the CLI, scaffold a project, fund testnet STX, deploy Clarity contracts, and run the Next.js frontend.

Deploy your first Stacks dApp to testnet in minutes. No Docker required. Prefer video? Watch the donation jar walkthrough. Prefer a finished app? Clone the example dApps.

Requires Clarinet 3.23+. Verify with stacksdapp doctor before you start.

1. Install the CLI

   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
   
2. Scaffold a project

   stacksdapp new my-app
   cd my-app
   

   This creates a counter contract (Clarity 6), Next.js frontend, network settings, stacksdapp.toml, and a bundled agent skill.

   Skip git init with stacksdapp new my-app --no-git.

3. 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"
   

   Never commit real mnemonics. The pre-commit hook blocks likely seed phrases in Testnet.toml and Mainnet.toml.

4. Deploy to testnet

   stacksdapp check && stacksdapp generate && stacksdapp test
   stacksdapp deploy --network testnet --yes
   

   Preview fees without broadcasting:

   stacksdapp deploy --network testnet --dry-run
   

   Addresses are written to frontend/src/generated/deployments.json.

5. Start the frontend

   stacksdapp dev --network testnet
   

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

   Connect Leather or Xverse set to Testnet. Public functions open a wallet popup; read-only functions call the node directly.

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.