Environment Setup

Set up your development environment for writing Move smart contracts on Sui.

Install Sui CLI

The Sui CLI is the primary tool for developing Move contracts.

Using Install Script (Recommended)

macOS/Linux

curl --proto --tlsv1.2 -sSf https://sh.rustup.rs | sh cargo

install --locked --git https://github.com/MystenLabs/sui.git --branch
mainnet sui ```
</Tab>

<Tab title="Windows">
```powershell # Install Rust first from https://rustup.rs cargo install
--locked --git https://github.com/MystenLabs/sui.git --branch mainnet sui

Verify Installation

sui --version

You should see output like: sui 1.x.x

Project Structure

Create your first Move project:

sui move new my_first_package
cd my_first_package

This creates the following structure:

my_first_package/
├── Move.toml           # Package manifest
├── sources/            # Move source files
│   └── my_module.move
└── tests/             # Test files

Move.toml Configuration

The Move.toml file defines your package configuration:

[package]
name = "my_first_package"
version = "0.0.1"

[dependencies]
Sui = { git = "https://github.com/MystenLabs/sui.git", subdir = "crates/sui-framework/packages/sui-framework", rev = "mainnet" }

[addresses]
my_first_package = "0x0"

Build Your Project

Test that everything is set up correctly:

sui move build

You should see: ✓ Build Successful

Editor Setup

VS Code (Recommended)

Install the Move language extension:

Open VS Code
Go to Extensions (Cmd/Ctrl + Shift + X)
Search for “Move” by “Mysten Labs”
Click Install

Other Editors

Vim/Neovim: move.vim
Emacs: move-mode

Configure Sui Client

Set up your Sui client to interact with networks:

# Initialize client
sui client

# Check active address
sui client active-address

# List available addresses
sui client addresses

# Get test tokens (testnet only)
sui client faucet

Available Networks

Mainnet

Production network for deployed applications

sui client new-env --alias mainnet --rpc https://fullnode.mainnet.sui.io:443
sui client switch --env mainnet

Testnet

Stable test network for development

sui client new-env --alias testnet --rpc https://fullnode.testnet.sui.io:443
sui client switch --env testnet

Devnet

Latest features (resets frequently)

sui client new-env --alias devnet --rpc https://fullnode.devnet.sui.io:443
sui client switch --env devnet

Localnet

Local node for development

# Start local node
sui start

# Connect to local node
sui client new-env --alias local --rpc http://127.0.0.1:9000
sui client switch --env local

Get Test Tokens

Request SUI tokens for testing (testnet/devnet only):

# Switch to testnet
sui client switch --env testnet

# Request tokens from faucet
sui client faucet

# Check your balance
sui client gas

Next Steps

Your environment is ready! Learn Move basics:

Move Basics

Learn Move syntax, types, and fundamental concepts

About Sui

Frontend - Workshop 1 (Escrow dApp)

Frontend - Workshop 2 (NFT Minting dApp)

Smart Contracts - Workshop 1 (Move Basics)

Environment Setup

Environment Setup

Install Sui CLI

Using Install Script (Recommended)

Verify Installation

Project Structure

Move.toml Configuration

Build Your Project

Editor Setup

VS Code (Recommended)

Other Editors

Configure Sui Client

Available Networks

Get Test Tokens

Next Steps

Move Basics

​Environment Setup

​Install Sui CLI

​Using Install Script (Recommended)

​Verify Installation

​Project Structure

​Move.toml Configuration

​Build Your Project

​Editor Setup

​VS Code (Recommended)

​Other Editors

​Configure Sui Client

​Available Networks

​Get Test Tokens

​Next Steps

Move Basics

Environment Setup

Install Sui CLI

Using Install Script (Recommended)

Verify Installation

Project Structure

Move.toml Configuration

Build Your Project

Editor Setup

VS Code (Recommended)

Other Editors

Configure Sui Client

Available Networks

Get Test Tokens

Next Steps