Quick Start

Quick Start with Move and PTB

💡 Key Terms

• Build – Compile Move code into modules.
• Test – Run Move unit tests.
• Deploy – Upload a package to the blockchain.
• Package Explorer – Displays deployed packages and functions.

1. Get Testnet Tokens (Faucet)

To deploy or execute PTBs, you need testnet or devnet SUI tokens. You can easily claim them from the official faucet:

👉 Official Faucet

💡 Make sure your network is set to testnet or devnet before using the faucet. 💡 The devnet resets weekly, which clears all on-chain data.

2. CLI Quick Start

Create and explore a new Move project from the command line.

sui move new hello_move
cd hello_move
sui move build
sui move test

This process automatically creates a Move package with Move.toml and a sources/ directory.

3. VS Code – Sui Extension Quick Start

Create a New Move Project

1. In Explorer View, right-click on a folder → select New Move Project.
2. In the popup, choose the Hello World template.
3. Click the Sui Extension icon in the Activity Bar.
4. The new project is automatically added to your Workspace. If multiple projects exist, check that the correct package is selected. If only one exists, it will be selected automatically. In the Workspace section, select hello_move and click Build / Test / Deploy.
5. Once deployment completes, a new Package Card appears in the Package Explorer.

💡 In the next chapter, you’ll explore Move’s asset model, learning how token minting and permission structures work.