Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ton-blockchain/acton/llms.txt
Use this file to discover all available pages before exploring further.
acton init adds Acton support to the current working directory without
creating a new project folder. It is the right command when you already have a
repository and want to layer in Acton.toml, the bundled standard library,
standard ignore patterns, and symlinks to global wallet and library overlays.
The command is safe to re-run at any time — it never overwrites an existing
Acton.toml and only appends missing entries to .gitignore.
Synopsis
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--create-dapp [PATH] | path | app | Skip project initialization and only create a Vite-based TypeScript app scaffold at PATH. The target directory must not exist. Conflicts with --stdlib-only. |
--stdlib-only | flag | false | Re-extract the bundled standard library into .acton/ without touching Acton.toml, .gitignore, or symlinks. Always refreshes even if the stored version already matches. Conflicts with --create-dapp. |
--color <WHEN> | auto | always | never | auto | Control coloured output. |
--manifest-path <PATH> | path | — | Accepted for CLI consistency; acton init does not require an existing manifest. Conflicts with --project-root. |
--project-root <PATH> | path | — | Accepted for CLI consistency; acton init does not require an existing project root. Conflicts with --manifest-path. |
Use cases
- Add Acton to an existing repo
- Create a dapp scaffold only
- Refresh the standard library
Run If
acton init inside any directory that contains .tolk files. Acton
scans the tree for files that define onInternalMessage, registers them as
contracts in a freshly created Acton.toml, and installs the standard
library.Acton.toml already exists, it is left completely untouched.What the default flow creates or patches
| Path | Behaviour |
|---|---|
Acton.toml | Created with discovered contracts if absent; left untouched if present. |
.gitignore | Missing Acton-related patterns are appended; existing patterns are never removed. |
.acton/tolk-stdlib | Installed or refreshed. |
global.wallets.toml symlink | Created when the global file exists and the local path does not yet resolve. |
global.libraries.toml symlink | Created when the global file exists and the local path does not yet resolve. |
--create-dapp, Acton only writes inside the new app directory.With
--stdlib-only, Acton only writes inside .acton/.
Contract auto-discovery
WhenActon.toml is created from scratch, Acton walks the current directory
tree and:
- skips hidden directories and
node_modules,target,.git,.acton - considers only
.tolkfiles - treats any file that defines
onInternalMessageas a contract entry file - derives the contract key from the file stem with
-→_ - derives the display name by splitting on
_/-and capitalising each word
Idempotency
acton init is safe to run repeatedly:
- never overwrites an existing
Acton.toml - only appends missing
.gitignorepatterns - refreshes
.acton/tolk-stdlibon every run - re-attempts symlink creation without breaking existing symlinks
--stdlib-only always re-extracts the standard library, even when the stored
version marker matches the current Acton version.