> ## Documentation Index
> Fetch the complete documentation index at: https://web3docs.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Sui Blockchain

> Learn about Sui's architecture, features, and development ecosystem

# Welcome to Sui Blockchain Development 🌊

Sui is a next-generation Layer 1 blockchain designed for instant transaction finality, high throughput, and low latency. Built by Mysten Labs, Sui introduces revolutionary concepts that make it ideal for building decentralized applications.

## What is Sui?

Sui is a **permissionless** Layer 1 blockchain that redefines asset ownership and programmability. Unlike traditional blockchains, Sui uses an **object-centric** data model where everything is an object, making it more intuitive and efficient for developers.

### Key Features

<CardGroup cols={2}>
  <Card title="Instant Finality" icon="bolt">
    Transactions achieve finality in milliseconds, not seconds or minutes
  </Card>

  <Card title="Parallel Execution" icon="arrows-split-up-and-left">
    Process thousands of transactions simultaneously using object ownership
  </Card>

  <Card title="Move Language" icon="code">
    Smart contracts written in Move, a secure and flexible programming language
  </Card>

  <Card title="Low Costs" icon="dollar-sign">
    Extremely low and predictable gas fees for transactions
  </Card>
</CardGroup>

## What You'll Learn

By the end of this workshop, you'll be able to:

1. **Install and configure** the Sui TypeScript SDK and dApp Kit
2. **Set up providers** for connecting to the Sui blockchain
3. **Connect wallets** using pre-built UI components
4. **Read blockchain data** using React hooks
5. **Sign and execute transactions** from your React application

## Prerequisites

Before starting this workshop, you should have:

* **Node.js** (v18 or higher) and **npm** or **pnpm** installed
* Basic knowledge of **React** and **TypeScript**
* Familiarity with **React Hooks** and context providers
* A code editor (VS Code recommended)

## Sui Development Stack

This workshop covers the complete Sui development stack:

### Frontend Development

Build user interfaces that interact with the Sui blockchain using:

* **React** - Modern UI framework
* **@mysten/dapp-kit** - Official Sui React SDK
* **TypeScript** - Type-safe development
* **@tanstack/react-query** - Data fetching and caching

### Smart Contract Development

Write on-chain logic using:

* **Move** - Sui's smart contract language
* **Sui CLI** - Command-line tools for development
* **Sui Framework** - Standard library and utilities
* **Testing Tools** - Unit and integration testing

## Why Build on Sui?

<AccordionGroup>
  <Accordion title="🚀 High Performance">
    Sui can process **thousands of transactions per second** with sub-second finality. The parallel execution model means your dApp won't be slowed down by network congestion.
  </Accordion>

  <Accordion title="💰 Low Cost">
    Gas fees on Sui are **extremely low** and **predictable**, making it
    economical to build applications with frequent on-chain interactions.
  </Accordion>

  <Accordion title="🔒 Secure by Design">
    Move's type system and ownership model prevent common smart contract
    vulnerabilities like reentrancy attacks and integer overflows.
  </Accordion>

  <Accordion title="👨‍💻 Developer Friendly">
    Comprehensive documentation, robust tooling, and an active community make it easy to get started and get help when needed.
  </Accordion>
</AccordionGroup>

## Development Paths

Choose your learning journey based on your interests:

<CardGroup cols={2}>
  <Card title="Frontend Development" icon="code" href="/sui/frontend/workshop-1/01-installation">
    Learn to build React dApps with wallet connection, data querying, and transaction signing
  </Card>

  <Card title="Smart Contracts" icon="file-contract" href="/sui/smart-contract/workshop-1/01-getting-started">
    Master Move programming to create secure and efficient on-chain logic
  </Card>
</CardGroup>

## What You'll Build

By the end of this workshop, you'll be able to:

**Frontend Development:**

* ✅ Connect users' Sui wallets to your dApp
* ✅ Query blockchain data efficiently
* ✅ Display user balances and owned objects
* ✅ Build and execute transactions
* ✅ Handle errors and edge cases gracefully

**Smart Contract Development:**

* ✅ Write Move modules with proper structure
* ✅ Define custom types and objects
* ✅ Implement transfer and ownership logic
* ✅ Deploy contracts to Sui networks
* ✅ Test contracts thoroughly

## Getting Started

Ready to start building? Choose your path:

<Steps>
  <Step title="Frontend Workshop">
    Head to [Installation](/frontend/02-installation) to set up your development environment and start building React dApps.
  </Step>

  <Step title="Smart Contracts">
    Jump to [Smart Contracts](/smart-contract/getting-started) to learn Move programming and deploy your first contract.
  </Step>
</Steps>

## Resources

<CardGroup cols={3}>
  <Card title="Sui Documentation" icon="book" href="https://docs.sui.io">
    Official docs and guides
  </Card>

  {" "}

  <Card title="SDK Reference" icon="code" href="https://sdk.mystenlabs.com">
    Complete API reference
  </Card>

  {" "}

  <Card title="Move Book" icon="book-open" href="https://move-book.com">
    Learn Move programming
  </Card>

  {" "}

  <Card title="GitHub Examples" icon="github" href="https://github.com/MystenLabs">
    Sample code and projects
  </Card>

  {" "}

  <Card title="Discord Community" icon="discord" href="https://discord.com/invite/Sui">
    Get help from developers
  </Card>

  <Card title="Sui Explorer" icon="magnifying-glass" href="https://suiscan.xyz">
    Explore the blockchain
  </Card>
</CardGroup>

Let's start building on Sui! 🚀

## Tech Stack

This workshop uses:

* **React** - UI framework
* **TypeScript** - Type-safe JavaScript
* **Vite** - Fast build tool
* **@mysten/dapp-kit** - Sui React SDK
* **@mysten/sui** - Core Sui TypeScript SDK
* **@tanstack/react-query** - Data fetching and caching

## Next Steps

Ready to get started? Let's begin by installing the necessary dependencies.

<Card title="Start Installation" icon="arrow-right" href="/sui/frontend/workshop-1/01-installation" horizontal>
  Move to the next section to install the Sui SDK
</Card>

```
```