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

# Painting Ranges

> How to build your ranges by painting cells on the 13×13 hand grid.

## How to paint cells

Building a range means marking which hands you play and what action you take with each one. You do this by "painting" cells on the grid.

<Steps>
  <Step title="Select an action color">
    In the action palette (right panel), click the action you want to paint with. For example, select "Raise" (green).
  </Step>

  <Step title="Click a cell">
    Click any cell in the grid to assign the active action to that hand. The cell fills with the action's color.
  </Step>

  <Step title="Or drag to paint multiple cells">
    Click and drag across the grid to paint several cells at once. This is the fastest way to fill in a range.
  </Step>
</Steps>

## Removing actions from cells

There are two ways to remove an action from a cell:

### Use the eraser tool

1. Click the **eraser** icon in the action palette.
2. Click or drag across cells to clear them.

### Click to toggle

If you click a cell that already has the active action, the action is removed from that cell.

## Clear all cells

To reset the entire grid:

1. Open the toolbar menu.
2. Select **Clear All**.
3. All cells are cleared. You can undo this with **⌘Z**.

## Keyboard shortcuts for painting

| Shortcut               | Action                                        |
| ---------------------- | --------------------------------------------- |
| **1–9**                | Switch to action 1 through 9 in the palette   |
| **Arrow keys**         | Move the selection cursor across the grid     |
| **Enter**              | Toggle the active action on the selected cell |
| **Delete / Backspace** | Clear the selected cell                       |
| **⌘Z** / **Ctrl+Z**    | Undo the last change                          |
| **⌘⇧Z** / **Ctrl+⇧Z**  | Redo                                          |

## Painting tips

<Tip>
  **Build ranges top-down.** Start with the strongest hands (top-left of the grid — premium pairs and suited broadways) and work outward. This mirrors how most ranges are structured.
</Tip>

* **Use drag for suited connectors** — Drag diagonally along the suited portion of the grid to quickly paint suited connector runs (T9s, 98s, 87s, etc.)
* **Use drag for suited aces** — Drag horizontally across the top row to paint suited ace combos
* **Check the combo count** — Watch the combo summary below the grid to make sure your range size makes sense for the position

## Auto-save

Every change you make to the grid saves automatically after a brief pause (500ms). You never need to click a save button. A small save indicator in the toolbar confirms when changes are saved.

If you make a mistake, press **⌘Z** to undo. RangeSharp supports up to **100 levels of undo**, so you can safely experiment.