# Interface and navigation

> One map of the lobby, the seven module entries, the agent panel, the companion, top-bar states and the keys you will use.

Source: https://loomworld.ai/docs/interface

## The lobby: Write and Shelf

The app starts in the project lobby with two tabs: “Write” is the conversation that creates a project, “Shelf” is everything you have. The shelf is an eight-sided 3D bookcase—left and right arrows turn a face, up and down change tier, hovering slides a book out, clicking opens it. When it fills up, “Shelf settings” adds a tier, names one with a wooden plaque, or marks the cell you face on entry as default. Eight cells per tier, eight books per cell; a cell name is only plaque text and classifies nothing.

The card menu also exports a project, moves it to the trash, restores it, deletes it permanently, or reveals it in Finder (desktop). A book that left via the trash remembers where it stood; returning it follows “own cell free → back home; taken → default cell; default full → next free cell”. Shelf layout belongs to this device: it does not travel with the project and does not sync to the account.

## Three regions inside a project

The middle is the current page’s workspace; the left rail holds the module entries plus the AI chat box; the right side changes per page—on Script it is always the companion (the chapter / scene / scene setting structure map), on a library page it is the detail drawer or inspector. At the bottom of the rail you can return to the lobby or collapse the chat box; below the navigation, the “Sources” list switches between “This chapter” and “Global”, which changes only what that list shows—never what AI reads or how statistics count.

Both side regions drag to width and the position is remembered; the sync chip and the notification bell sit beside the project name. Collapse the session list and the main workspace keeps its width, so the draft can take the screen.

## What each of the seven entries holds

Script

The only place text is written: nine node types, four structure layers, right-click connect and rewrite.

Beats

Derived analysis: density curve, chapter colour blocks, appearance heatmaps, the Foreshadowing Manager.

Characters

Roster, relationship graph, per-chapter change, appearance counts.

Locations

Hierarchy plus 3D and flat maps.

Props

Owners, transfer chains, narrative weight.

World

Citable entries, faction / organization membership, the four leaderboard types.

Timeline

Several plotlines: card flow for order, scale axis for years and duration.

Top bar

Sync state, the notification bell, the account menu (usage / settings / sign out).

All seven read one dataset, so nothing is “changed there, stale here”. Cross-module effects: [Cross-module links](https://loomworld.ai/docs/cross-sync).

## The chat box: the only AI entrance

The AI chat box floats at the left of the workspace. Drag it somewhere it does not cover your text—it will not close when you click outside. A project can hold several sessions: create, rename, and collapse them; the current session belongs to this project only. In the composer, `@` pulls a specific character, scene, or passage into this round, and images can be attached.

Right-click rewrite actions from the draft are executed here too—so “what did it do, and where did I get to” always has exactly one place to look. See [Chat to proposal](https://loomworld.ai/docs/ai-chat).

## The top bar: sync, notifications, account

- Sync state is always visible: Synced / Syncing / Offline / Sync failed / Paused / Conflict. A cloud failure changes only that state; it never unwinds what already saved locally.
- The bell holds creative results: agent tasks finishing or failing, and background maintenance outcomes. Opening one jumps to the target and marks it read; if the target is unavailable, the unread stays.
- The account menu shows current credits and “usage”, and is where settings and sign-out live.

## Four sections in settings

Account menu → Settings, with four sections on the left: General (interface and alerts, editor, privacy and about), Project settings (basics, creative baseline, writing style, AI settings), Project data (snapshots, export, backup, archive box, danger zone), and Account (credits, records, devices and security, deletion). The project-specific sections need a project open first.

Item-by-item wording: [Settings and project data](https://loomworld.ai/docs/settings-data).

## Keys and right-clicks you will actually use

- On a script line, `Tab` or `/` opens the type menu; `1`–`9` picks; `Esc` closes.
- Undo / redo everywhere: `Cmd/Ctrl` + `Z` and `Shift+Cmd/Ctrl` + `Z` (or `Ctrl+Y`)—one project-wide timeline.
- Select script text and right-click: rewrite / expand / condense / polish, plus “Connect to…”.
- Type `@` in a long-text field to insert a reference.
- Interface zoom `⌘=` / `⌘-` / `⌘0`; the timeline scale axis zooms with `Shift` + wheel.

## Limits and troubleshooting

- The shelf is for finding and opening work, not for filing it: cell names and placements change nothing about a project and do not sync.
- Settings → Project settings / Project data require an open project; with none, those sections tell you to return to the lobby.
- Signed out, cloud sync and AI are skipped silently, while browser-local projects keep working—export a pack so the work is not trapped in one browser.
- Desktop and Web store locally in different places: one project is one folder on disk in the desktop app, and browser storage in the Web app.
