Prerequisites

Set up your development environment for Scaffold Stacks

Install the tools below before using Scaffold Stacks. All versions listed are minimums.

Contents

• Requirements
• Install the CLI
• Verify installation
• Rust
• Node.js
• Clarinet
• Stacks wallet
• Docker (optional)

Requirements

Tool	Minimum version	Required for
Rust	1.75+	Building and installing the CLI
Node.js	20+	Frontend and contract tests
Clarinet	3.21+	Contract toolchain
Leather or Xverse	latest	Testnet and mainnet wallet flows
Docker Desktop	latest	Local devnet only

Install the CLI

cargo install stacksdapp
stacksdapp --version

Or build from source:

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

Verify installation

stacksdapp doctor

Checks Rust, Node.js, Clarinet 3.21+, Docker (for devnet), and git.

To verify manually:

rustc --version && node --version && clarinet --version

If doctor passes, continue to the quickstart.

Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup update

Verify:

rustc --version

Node.js

# Using nvm (recommended)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

Verify:

node --version
npm --version

Clarinet

Scaffold Stacks templates target Clarinet SDK 3.21.

# macOS with Homebrew
brew install clarinet

# Or build from source
git clone https://github.com/stx-labs/clarinet
cd clarinet
cargo install --path .

Verify:

clarinet --version

Stacks wallet

Install a browser wallet and create a testnet account:

• Leather
• Xverse

Docker (optional)

Required only for local devnet:

# macOS
brew install --cask docker