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

# Quickstart

> Get started with Kwala - Set up wallet and get ready to build your first workflow

Before you can create and run Kwala workflows, you need to set up your wallet and get Kwala credits. This guide walks you through the complete setup process in three steps.

## Step 1: Connect your Web3 wallet

Kwala currently supports MetaMask for wallet connections, with support for additional Web3 wallets coming soon.

<Info>
  This quickstart uses MetaMask to connect your wallet and get started with Kwala.
</Info>

<Steps>
  <Step title="Install a Web3 wallet">
    If you don't already have a wallet, download and install one. For MetaMask, visit [metamask.io](https://metamask.io). You'll need to:

    * Create a new wallet or import an existing one
    * Save your recovery phrase securely
    * Configure it for BNB Smart Chain network (required for purchasing credits)
  </Step>

  <Step title="Navigate to the Kwala dashboard">
    Open the [Kwala dashboard](https://Kwala.network/dashboard), and select **My Workflows** to access the workflow builder.

    <Frame>
      <img src="https://mintcdn.com/kwala-1f7da9fb/eCmxMl9Czq59OEnM/images/getting-started/quickstart/kwala-dashboard.PNG?fit=max&auto=format&n=eCmxMl9Czq59OEnM&q=85&s=9dd04b928a6cc0c6f4f9c8e8db0acbfd" alt="Kwala dashboard interface" width="994" height="647" data-path="images/getting-started/quickstart/kwala-dashboard.PNG" />
    </Frame>
  </Step>

  <Step title="Connect your wallet">
    On the dashboard, select the **Connect Wallet** button. Choose your preferred wallet from the available options.
  </Step>

  <Step title="Authorize connection">
    Approve the connection request in your MetaMask wallet to link it with the Kwala network.
  </Step>

  <Step title="Verify connection">
    Once connected, you'll see your wallet address displayed in the dashboard. You can disconnect your wallet at any time by selecting your address.
  </Step>
</Steps>

## Step 2: Purchase Kwala credits

Kwala uses a credit-based system to execute workflows. Follow these steps to add Kwala credits to your account:

<Steps>
  <Step title="Open the Kwala payments page">
    Navigate to [payments.Kwala.network](https://payments.Kwala.network/) to access the payment portal.
  </Step>

  <Step title="Purchase credits">
    Choose your preferred payment method:

    * **Wallet Swap**: Directly swap USDT for Kwala credits from your connected wallet (instant)
    * **Easy Transfer**: Send USDT to a provided address to purchase credits
  </Step>
</Steps>

For a detailed step-by-step guide on purchasing Kwala credits, including wallet connection and payment methods, see our [Get Kwala Credits](/getting-started/get-kwala-tokens) guide.

## Step 3: Build your first workflow

Once your wallet is set up and you've purchased credits, you're ready to create your first Kwala workflow.

<Note>
  If you're building workflows that monitor smart contract events or execute contract functions, ensure your contracts are deployed. You can deploy smart contracts through Kwala or use a contract that's already deployed on a blockchain of your choice.
</Note>

<Steps>
  <Step title="Create new workflow">
    Select the **Create Your First Workflow** or **New Workflow** button on your dashboard.

    <Frame>
      <img src="https://mintcdn.com/kwala-1f7da9fb/eCmxMl9Czq59OEnM/images/getting-started/quickstart/create-new-workflow.PNG?fit=max&auto=format&n=eCmxMl9Czq59OEnM&q=85&s=d541542cbcb64900edcde540cc66abaf" alt="Create new workflow button on dashboard" width="982" height="612" data-path="images/getting-started/quickstart/create-new-workflow.PNG" />
    </Frame>
  </Step>

  <Step title="Choose a starting point">
    You can either:

    * Start from a blank workflow
    * Use a pre-built template
    * Import an existing YAML file
  </Step>

  <Step title="Configure your workflow">
    Use the **Workflow Builder** to visually configure your workflow. This form-based UI lets you set up triggers, actions, and execution settings without writing YAML.

    <Frame>
      <img src="https://mintcdn.com/kwala-1f7da9fb/eCmxMl9Czq59OEnM/images/getting-started/quickstart/kwala-workflow-builder.PNG?fit=max&auto=format&n=eCmxMl9Czq59OEnM&q=85&s=5e9fb307f9c631e7b2331f077362d97b" alt="Kwala workflow builder interface" width="655" height="278" data-path="images/getting-started/quickstart/kwala-workflow-builder.PNG" />
    </Frame>

    In the workflow builder:

    * Provide a name for your workflow
    * Add trigger configuration
    * Add up to 10 actions to execute when trigger conditions are met
    * Configure the execution mode

    Once done, Kwala generates the complete YAML automation script based on your configurations. Save the workflow.
  </Step>

  <Step title="Review and edit your workflow">
    After saving, your workflow opens in the **Workflow Editor** where you can view and modify the generated YAML directly.

    <Frame>
      <img src="https://mintcdn.com/kwala-1f7da9fb/eCmxMl9Czq59OEnM/images/getting-started/quickstart/kwala-workflow-editor.PNG?fit=max&auto=format&n=eCmxMl9Czq59OEnM&q=85&s=34c94dc6445dcc94ee0934bb3fe6efb5" alt="Kwala workflow editor interface" width="983" height="887" data-path="images/getting-started/quickstart/kwala-workflow-editor.PNG" />
    </Frame>

    In the workflow editor, you can fine-tune:

    * **Name**: Update your workflow's name
    * **Execution mode**: Switch between parallel or sequential execution
    * **Triggers**: Adjust when your workflow should run
    * **Actions**: Modify contract calls, API endpoints, or notification settings

    <Tip>
      You can switch back to the visual Workflow Builder at any time by selecting the **Workflow Builder** button in the top navigation pane.
    </Tip>
  </Step>

  <Step title="Test your workflow">
    Before you deploy the workflow, use the **Compile** feature to validate your configuration. This validates your workflow for syntax and schema correctness. You can use the **Console Logs** tab for more details about your workflow, including any validation errors.
  </Step>

  <Step title="Deploy and execute">
    Once you're satisfied with your workflow, **Deploy** it to the Kwala network and **Activate** it.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Create Your First Workflow" icon="file-code" href="/workflow-builder/explore-the-playground">
    Learn how to write Kwala scripts
  </Card>

  <Card title="YAML Basics" icon="book" href="/concepts/yaml-workflow-basics">
    Understanding Kwala's YAML structure
  </Card>
</CardGroup>