Quickstart

Scaffold a counter contract, install dependencies, and start the development UI.

Prerequisites

• Acton 1.1.0 or later installed.
• Node.js 22 or later LTS: required for the TypeScript app scaffold added by --app.

Create a project

acton new scaffolds a new project directory from a built-in template:

• counter template ships with a ready-made contract, tests, and a deployment script.
• --app flag adds a Vite-based React frontend scaffold and generated TypeScript wrappers alongside the Tolk sources.

acton new first_counter --template counter --app
cd first_counter

Build the contract:

acton build

Run tests:

acton test

Install NPM dependencies:

npm ci

Start the Vite development server:

npm run dev

Open the URL shown in the terminal output. Connect a wallet using TON Connect, then deploy and interact with the counter contract by sending transactions on the testnet or mainnet.

Next steps

• Familiar with TON — the walkthrough continues from this point: build, test with coverage and mutation analysis, set up a wallet, deploy, and verify on-chain.
• New to TON contracts — follow the tutorial for a step-by-step introduction to smart contract development on TON with Tolk and Acton.