Upgrade a project

Upgrade Scaffold Stacks dependencies, regenerate TypeScript bindings and React hooks, and refresh the agent skill with stacksdapp upgrade.

Run stacksdapp upgrade on an existing Scaffold Stacks project to refresh npm dependencies, regenerate TypeScript bindings, update git hooks, and refresh the bundled agent skill. It does not rescaffold your repo or overwrite application code.

Contents

• Requirements
• Run upgrade
• When to use it
• Init vs upgrade
• After upgrading

Requirements

Your project must already use the scaffold layout:

Path	Required
contracts/Clarinet.toml	Yes
frontend/package.json	Yes

Clarinet 3.23+ is required. Run stacksdapp doctor to verify your toolchain.

Run upgrade

cd my-dapp
stacksdapp upgrade

The command:

1. Normalizes standard Clarinet layout if needed
2. Writes stacksdapp.toml if missing
3. Refreshes npm dependencies in frontend/ and contracts/
4. Runs npm ci when a package-lock.json is present
5. Runs stacksdapp generate
6. Refreshes .githooks/pre-commit (mnemonic guard)
7. Refreshes bundled agent skill files
8. Sets git config core.hooksPath .githooks when in a git repo

You should see install progress for both packages, then codegen output.

When to use it

• After installing a newer stacksdapp release
• After Clarinet or @stacks/clarinet-sdk template updates
• When generated files no longer match your .clar sources
• To refresh the AI agent skill and git hooks to the latest versions

Init vs upgrade

Command	Use case
stacksdapp init	First time adopting an existing Clarinet project
stacksdapp upgrade	Project is already scaffolded; refresh deps, bindings, hooks, and skill

After upgrading

stacksdapp check
stacksdapp test
stacksdapp generate --watch   # optional: keep bindings in sync while editing