Skip to main content
For smart contract development on TON Blockchain, Blueprint is an all-in-one development environment designed to enhance the process of creating, testing, and deploying smart contracts. It includes:
  • Blueprint — core tools for building contracts.
  • Sandbox — fast local testing in an isolated blockchain.
  • Create TON App — scaffolding a ready-to-use project.
  • Testing utils — testing helpers and unit test matchers.
This section covers development, testing, smart contracts deployment and interaction, performance benchmarks, and blueprint configuration and reference.

​
Quick start

To get started immediately, run the following command to create a new project and follow the on-screen instructions: 
npm create ton@latest

​
Key features

  • Project scaffolding — create a ready-to-use development environment with npm create ton@latest.
  • Streamlined workflow — build, test, and deploy smart contracts efficiently.
  • Simple deployment — publish contracts to Mainnet and Testnet directly from your wallet.
  • Fast local testing — run multiple contracts in an isolated in-process blockchain.

​
Requirements

  • Node.js version 22 or later
  • Verify the version with node -v

​
IDE plugins

​
Environment setup

  1. Run and follow the on-screen instructions: npm create ton@latest.
  2. From the project directory, run npm install to install dependencies.

​
Project structure

  • contracts/ — smart contract source code and imports.
  • scripts/ — deployment scripts for Mainnet and Testnet, as well as scripts for interacting with live contracts.
  • tests/ — TypeScript test suite for all contracts, using Sandbox for in-process execution.
  • wrappers/ — TypeScript interface classes for all contracts except Tact.
    • Each wrapper implements the Contract interface from @ton/core.
      • Provides message serialization and deserialization, getter wrappers, and compilation helpers.
      • Used in both the test suite and client code to interact with contracts from TypeScript.
  • build/ — compilation artifacts generated by the build command.