> For the complete documentation index, see [llms.txt](https://docs.tempoweave.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tempoweave.com/tempoweave-mobile/finding-your-way-around-mobile.md).

# Finding Your Way Around (Mobile)

Where everything lives in TempoWeave Mobile — the layouts, the panels, and the touch gestures.

***

### Two layouts, one app

TempoWeave Mobile adapts to your screen:

* **Tablets (iPad, Android tablets)** — panel buttons run down a **side rail**; tapping one slides its panel in from the side, next to your draft.
* **Phones** — the same buttons sit in a **dock along the bottom**; tapping one slides its panel up as a sheet.

The buttons are Home, Project, Design, Tools, Yarns, View, **Cloud** and Help. Cloud opens a panel with your account, MyCloud and sharing, the same actions as **☰ → CLOUD**.

Same features, same names, different furniture. This guide says "panel" for both.

***

### The top bar

Left to right:

| Control                 | What it does                                                                                                                                                                                  |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **☰**                   | The main menu — file operations, cloud, account, settings (see below)                                                                                                                         |
| **🗂**                  | Browse Drafts — your drafts on this device and in MyCloud, one tap (also **☰ → Browse Drafts…**)                                                                                              |
| **Filename**            | The active draft                                                                                                                                                                              |
| **✎ Pencil**            | Structure editing mode — tap cells in the threading, treadling, or tie-up                                                                                                                     |
| **🖌 Brush**            | Color mode — the palette appears; tap a swatch, then paint warp/weft threads                                                                                                                  |
| **Selection** (tablets) | The Selection menu: Selection Mode, Select All Warp / Weft, Unselect All, Cut, Copy, Paste (Replace or Insert), Clear Selection, Delete Thread, and Repeat To… — the same as Home ▸ Selection |
| **↶ ↷**                 | Undo / Redo                                                                                                                                                                                   |
| **✋**                   | Pan mode — one-finger drags scroll the draft instead of editing                                                                                                                               |

With neither pencil nor brush active you're in **read mode** — safe to handle the screen without changing anything.

Below the top bar, each open draft has a **tab**; tap to switch, **✕** to close. On phones the tabs are finger-sized, with a close target that runs the full height of the tab, and long names are trimmed so more tabs fit. Closing the last one returns you to Browse Drafts, which stays on screen until you open or create a draft.

**Where is my draft saved?** The tab tells you at a glance: 📱 means a copy is on this device, ☁️ means it is in MyCloud, both glyphs mean both, and ☁️↑ means the MyCloud copy is behind because your latest save has not reached the cloud yet. Tap that 📱 / ☁️ icon on a tab to see the full answer (tapping the rest of the tab only switches to it): where it lives, when it was last saved to each place, and, when one is missing, a button to **Save a copy to this device** or **Add to MyCloud**. **Save As makes another draft**: the new file is not connected to MyCloud, and the original stays connected, so a renamed draft arrives in MyCloud under its own name when you add it. Only **Save a copy to this device** on this sheet keeps the copy connected. The sheet also shows the name the draft has in MyCloud when it differs from the file name; the two are separate and nothing renames either on its own. When they differ, a **Rename in MyCloud to match this file** button makes them agree.

***

### The ☰ menu

* **ACCOUNT** — **Sign In…** (unlocks your licensed features and your cloud).
* **FILE** — **Browse Drafts…**, **Open Local Draft…**, **New Draft…**, **Save**, **Save As…**, **Export WIF…** (see the Drafts & Library guide).
* **PROJECT** — **Project Info…** (title, notes, sett, yarn calculations, tags), **Snapshots…** (named version history).
* **CLOUD** — **Share Pattern…**, **My Patterns…**, **Browse Public Patterns…**, **Open Shared Pattern…**.
* **APP** — **Settings…**, **About TempoWeave**.

Tap anywhere outside the menu to dismiss it.

***

### The panels

The panels are organized to mirror the desktop menus, so what you learn in one app carries to the other.

**Home** — everyday editing:

* **EDITORS** — **Edit Threading** and **Edit Treadling** open a full-screen editor built for fingers: a big grid, the color strip, thread or pick numbers, and a **dedicated scroll lane** that is the only place a drag scrolls. Anywhere on the grid, a drag draws. Both have Undo and Redo, all the drawing tools in the header, zoom in and out, and a tool-head marker that rides with your finger so you can see the cell you are acting on. Rotating the device re-fits the grid. The editor opens at the part of the draft you were looking at, and the drawdown shows dimmed beside the grid, updating as you draw, so you can see what each change does to the cloth. A **long-press** on the threading or treadling in the main view opens the matching editor at that spot.
* **DRAWING TOOLS** — Straight Draw, Free Draw, Line, Point Draw, and Eraser for the pencil mode, in the same order as on desktop. The tool you're using is ticked in every tool menu.
* **SELECTION** — **Select All Warp**, **Select All Weft**, then Cut, Copy, Paste (Replace or Insert), and Clear for whatever range you've selected, and **Repeat To…** (see below). **Cut** works as on desktop: it copies the selection and then clears it, so the threads stay in place, empty.
* **ADD / REMOVE THREADS** — **Insert Thread** adds a thread at the cursor. **Delete Thread** removes the selected threads or picks (or, with nothing selected, the one at the cursor) and closes the gap; when nothing is threaded after them, it clears them instead.
* **DRAFT** — **Lock Draft** to protect a finished design.

**Project** — **Project Info…**, the **Multi-treadle** toggle, **Print / PDF…**, and **Snapshots…**.

**Design** — draft structure, grouped like desktop's Design menu:

* **COMMON WEAVES** and **SECTIONS**.
* **TIE-UP** — **Tie-Up Diagonal…**, Clear, Invert, **Delete Treadles** (removes the treadles selected in the tie-up, closes the gap and renumbers the treadling; asks first when picks use them), **Shift Tieup…**, and **Repeat by Quarters…** (copies a block of the tie-up, or of the liftplan, into the three quarters around it, each turned its own way; see [Tie-Up Functions](https://docs.tempoweave.com/help-by-menu-tabs/design-menu/tie-up-functions.md) in the TempoWeave Studio guide).
* **WARP** — Clear, Reverse, Mirror, **Invert**, **Rotate**, and **Shift Warp…**.
* **WEFT** — the same set for the weft.
* **MODE** — convert between liftplan and tie-up.

The **Shift…** entries open a card with four arrow buttons — each tap shifts the whole warp, weft, or tie-up one step (with optional wrap-around), and colors and thickness travel with the threads.

**Tools** — the workhorses, grouped like desktop's Tools menu:

* **ASSISTANTS** — Weave Assistant and Thread Assistant.
* **ANALYSIS** — Float Check.
* **WEFT** — **Tromp as Writ…** with the same three options as desktop (structure only, structure and color, color only).
* **TABBY** — Add and Remove Tabby.
* **TRANSFORM** — Turn Draft and Rotate Draft, and **Repeat To…** (the same as in Home ▸ Selection).
* **OPTIMIZE** — Reduce Shafts, Reduce Treadles, Expand Treadles.
* **TIE-UP** — Arrange Shafts and Arrange Treadles.

After Turn Draft, Rotate Draft, Reduce Shafts, Reduce Treadles, Expand Treadles or Add Tabby, the tie-up resizes to the draft's new shafts and treadles, so nothing is cut off and no empty columns are left over. Undo after **Common Weaves** puts the tie-up and treadling back at their old size too.

**Repeat To…** repeats the selected warp threads or weft picks through a thread or pick number you type. Select the threads or picks first, tap **Repeat To…**, type the last thread or pick, and choose whether colors and thickness repeat too (**Include colors**, **Include thickness**). The repeats start just after the selection and stop at your number, so the last repeat is cut off there. If existing threads or picks would be replaced, the app says how many and asks first (**Replace**); Undo puts them back. The view stays where you are afterwards; it no longer jumps to the end of the draft after Repeat To, Undo, or drawing past the last thread.

**Yarns** — the **Yarn Catalog** (real yarn lines with colors, photos, and sett suggestions), **My Yarns**, the **gradient tool**, color painting, and palette position.

**View** — how the draft is displayed: view styles, **Fabric view**, **3D interlacement**, zoom options.

**Help** — the **TempoWeave Mobile Guide** (this documentation), **Feedback / Support**, and **About**.

A panel stays open while you work; tap its button again (or the ✕) to close it.

***

### Touch gestures

| Gesture                                      | What it does                                                                                                        |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Pinch**                                    | Zoom the draft in or out                                                                                            |
| **Two-finger drag**                          | Pan (scroll) the draft — works in any mode                                                                          |
| **One-finger drag on the drawdown**          | Pans in read/pan mode; edits in pencil/brush mode                                                                   |
| **Drag on the warp/weft headers**            | Scrolls the draft (headers never edit by drag-scroll)                                                               |
| **Tap**                                      | Edits a cell (pencil), paints a thread (brush), or selects a swatch (palette)                                       |
| **Long-press on the threading or treadling** | Opens Edit Threading or Edit Treadling at that spot (in read mode or pencil mode; the press itself changes nothing) |

If you keep editing when you meant to scroll: tap **✋** to switch drags to panning, or leave pencil/brush mode.

One drawing rule applies everywhere the pencil works — the main view, the tie-up and liftplan, and the Edit Threading / Edit Treadling editors:

* **Tap a marked cell to clear it.** The one-tap fix for an errant pick or end, with any tool.
* **A drag only ever fills.** A stroke that starts on a filled cell paints forward instead of wiping out everything it crosses.
* **Eraser** is the bulk tool: tap or drag to clear a swath. It is on the pencil menu with the other tools.
* **Drawing past the edge** of the threading, treadling or liftplan keeps drawing along the edge cell instead of stopping.

***

### The palette strip

In brush mode a **color palette** appears — across the top or down the right edge (your choice in Settings). Colors already used in the draft are gathered at the start of the strip, then the full palette follows. Tap a swatch to make it the active color — **its name (and yarn line, for catalog colors) appears beside the strip** so you know exactly what you picked.

**Press and hold** a swatch (or tap **Edit Selected Color…** in the Yarns panel for the active color) to open **Edit Yarn** for that color: its name, yarn line, thickness, sett and more. **Change Color…** opens the color picker, and on a device with a camera **📷 From Camera…** picks the color from the real yarn: point the camera at the yarn, pinch or slide to size the sample circle, and tap **Use This Color**.

***

### Keyboards and the iPad menu bar

With a hardware keyboard attached, **⌘Z** undoes and **⇧⌘Z** redoes. On Android keyboards it's **Ctrl+Z**, with **Ctrl+Shift+Z** or **Ctrl+Y** to redo. While you're typing in a text box, those keys undo and redo the typing instead.

**iPad menu bar (iPadOS 26).** Swipe down from the top of the screen, or point at the top with a trackpad or mouse, to bring up the menu bar: **TempoWeave**, **File**, **Edit**, **View**, **Design**, **Tools** and **Help**. Each item does the same as its button or panel entry. Shortcuts:

| Shortcut     | Command            |
| ------------ | ------------------ |
| ⌘N           | New Draft…         |
| ⌘O           | Open Local Draft…  |
| ⇧⌘O          | Browse Drafts      |
| ⌘S / ⇧⌘S     | Save / Save As…    |
| ⌘P           | Print / PDF…       |
| ⌘W           | Close Tab          |
| ⌘Z / ⇧⌘Z     | Undo / Redo        |
| ⌘X / ⌘C / ⌘V | Cut / Copy / Paste |
| ⇧⌘V          | Paste (Insert)     |
| ⌘= / ⌘−      | Zoom In / Zoom Out |
| ⇧⌘0          | Fit to Window      |
| ⌘,           | Settings…          |

Design has Tie-Up, Warp, Weft and Color submenus, and Tools holds the Tools panel's operations along with the Weave and Thread Assistants.

**iPad in a window.** When TempoWeave runs in a window (iPadOS 26 windowed apps or Stage Manager), the top bar, the Weave and Thread Assistant bars and the Edit Threading / Edit Treadling editors move right to clear the window's close, minimize and full-screen buttons. The status bar stays visible, so tapping the top of the window brings up the window controls and the menu bar, as in other apps.

***

### App settings

**☰ → Settings…** holds app-wide preferences: palette position, display options, and more. Draft-specific settings (sett, title, notes, tags) live in **Project Info**; Weave and Thread Assistant settings live inside each assistant's ⚙.

***

*See also: TempoWeave Mobile: Quick Start and Your Drafts & the Library.*
