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

# Quick Start

> Get up and running with bundl in under 2 minutes

This guide will walk you through creating your first wallet and making your first transaction with bundl.

<Steps>
  <Step title="Launch bundl">
    Open bundl from your Applications folder (macOS), Start menu (Windows), or application launcher (Linux).
  </Step>

  <Step title="Create a Master Password">
    On first launch, you'll be prompted to create a master password. This password:

    * Encrypts all your wallet data
    * Is required every time you open bundl
    * **Cannot be recovered** – if you forget it, you lose access to your wallets

    <Warning>
      Choose a strong, unique password and store it securely. We recommend using a password manager.
    </Warning>
  </Step>

  <Step title="Create Your First Wallet">
    After setting your password, you'll see the empty dashboard. Click **\[+ create]** to create your first wallet.

    1. Enter a label (e.g., "main-wallet")
    2. Click **\[create]**
    3. Your wallet is created with a new keypair
  </Step>

  <Step title="Fund Your Wallet">
    Copy your wallet address by clicking it, then send SOL from another wallet or exchange.

    <Tip>
      For testing, switch to **Devnet** in the network selector and request an airdrop by clicking the wallet menu → **Request Airdrop**.
    </Tip>
  </Step>
</Steps>

***

## The Dashboard

Once you have wallets, here's what you'll see:

```
┌────────────────────────────────────────────────────────────┐
│ bundl                                     mainnet ▼  🔒    │
├────────────────────────────────────────────────────────────┤
│ balance: 42.5831 SOL │ wallets: 3 │ ▶ portfolio            │
├────────────────────────────────────────────────────────────┤
│                                                            │
│  ☐  main-wallet          8xK4...3nPq      15.2341 SOL     │
│  ☐  trading-1            5yR2...9mKj       8.0000 SOL     │
│  ☐  nft-holder           3pL7...2vXw       5.5000 SOL     │
│                                                            │
├────────────────────────────────────────────────────────────┤
│ [+ create]  [send]  [collect]  [swap]  [export]           │
└────────────────────────────────────────────────────────────┘
```

### Key Elements

| Element              | Description                                  |
| -------------------- | -------------------------------------------- |
| **Network Selector** | Switch between Mainnet and Devnet            |
| **Lock Icon**        | Lock the app (requires password to unlock)   |
| **Balance**          | Total SOL across all wallets                 |
| **Portfolio Toggle** | Show/hide the portfolio dashboard            |
| **Wallet List**      | All your wallets with addresses and balances |
| **Action Bar**       | Quick actions for wallet operations          |

***

## Core Actions

### Sending SOL

1. Click on a wallet to open its details
2. Click **\[send]**
3. Enter the recipient address
4. Enter the amount
5. Click **\[send]**

Or use the global **\[send]** button in the action bar.

### Receiving SOL

1. Click on a wallet to view details
2. Click the address to copy it
3. Share the address with the sender

### Viewing Tokens

Click on any wallet to see:

* SOL balance
* All SPL tokens with logos, symbols, and USD values
* Token-2022 tokens (marked with "T22" badge)

### Transaction History

In the wallet detail view, scroll down to see recent transactions:

* Transfers (sent/received)
* Swaps
* NFT sales
* Token transfers

***

## Keyboard Shortcuts

bundl is designed for keyboard-first usage:

| Shortcut         | Action                 |
| ---------------- | ---------------------- |
| `⌘ K` / `Ctrl K` | Open command palette   |
| `⌘ N` / `Ctrl N` | Create new wallet      |
| `⌘ L` / `Ctrl L` | Lock the app           |
| `Escape`         | Close dialogs          |
| `↑ / ↓`          | Navigate wallet list   |
| `Space`          | Select/deselect wallet |
| `⌘ A` / `Ctrl A` | Select all wallets     |

### Command Palette

Press `⌘ K` (or `Ctrl K`) to open the command palette. Type to search:

* `send` – Open send dialog
* `swap` – Open Jupiter swap terminal
* `create` – Create a new wallet
* `lock` – Lock the app
* `export` – Export wallets

***

## Multi-Select Operations

bundl shines when managing multiple wallets at once.

### Selecting Wallets

* Click the checkbox next to a wallet to select it
* Use `Shift + Click` to select a range
* Use `⌘ A` to select all

### Selection Action Bar

When wallets are selected, a new action bar appears:

```
┌────────────────────────────────────────────────────────────┐
│ 3 selected    [deselect all]  [send]  [collect]  [sweep]  │
└────────────────────────────────────────────────────────────┘
```

* **\[collect]** – Collect all SOL from selected wallets to one destination
* **\[sweep tokens]** – Sweep a specific token from all selected wallets

***

## Network Selection

bundl supports both Mainnet and Devnet:

| Network     | Use Case                                |
| ----------- | --------------------------------------- |
| **Mainnet** | Real transactions with real SOL         |
| **Devnet**  | Testing and development (free airdrops) |

To switch networks:

1. Click the network dropdown in the top right
2. Select **mainnet** or **devnet**

<Info>
  Your wallets work on both networks. The same address, different balances.
</Info>

### Devnet Airdrops

On Devnet, you can request free SOL for testing:

1. Switch to **Devnet**
2. Click on a wallet
3. Click the menu (**•••**) → **Request Airdrop**
4. 1 SOL will be deposited (limited to a few per hour)

***

## Locking the App

bundl automatically locks when you close it. To manually lock:

* Click the **🔒** icon in the top bar
* Or press `⌘ L` / `Ctrl L`
* Or use the command palette → `lock`

When locked, all wallet data is encrypted and inaccessible until you enter your master password.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Wallet Management" icon="wallet" href="/features/wallet-management">
    Create, rename, delete, and organize wallets
  </Card>

  <Card title="Batch Operations" icon="layer-group" href="/features/batch-operations">
    Create 50 wallets at once, collect funds from many
  </Card>

  <Card title="Token Sweeper" icon="broom" href="/features/token-sweeper">
    Collect all tokens from multiple wallets
  </Card>

  <Card title="Upgrade to Pro" icon="bolt" href="/pro/upgrade-guide">
    Unlock unlimited wallets and advanced features
  </Card>
</CardGroup>