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

# Canvas

> Render text, data, or analysis into a laid-out visual panel — annotate directly on the canvas and share it with your team in one click.

Canvas lets the Agent turn text, data, or analysis into a laid-out panel with stat cards, tables, charts, and more. You can annotate directly on the canvas to collaborate on changes, and share it with your team in one click.

## What Canvas is

* **A visual view of the Agent's output** — chunky text becomes a paneled layout that's easier to scan.
* **A standard `.canvas.tsx` file** — the Agent generates or edits this file, and every change is reflected live in the Canvas preview.
* **Prompt-driven edits** — no need to hand-edit the source; describe the change you want in chat and the Agent updates the source and re-renders automatically.

## Use cases

* **Dashboards** — after the Agent analyzes logs or metrics, it builds a dashboard in Canvas with KPIs and trend charts at a glance.
* **Structured reports** — turn dense findings (profiling, dependency analysis, and the like) into sectioned panels instead of walls of text.
* **Architecture and flow visualization** — when clarifying system behavior or writing docs, render state flows, module dependencies, or high-level architecture so the team stays aligned.

## How to use

Trigger Canvas with the `/canvas` command in chat:

* **First render**: describe what you want on the canvas. The Agent creates the `.canvas.tsx` file and renders it in the Canvas preview.
* **Iterate**: keep prompting the Agent in the same conversation, or annotate directly on the Canvas — the Agent updates the source and re-renders.

## Annotation

Annotation lets you point directly at what needs adjusting on the Canvas so the Agent understands your feedback more precisely — pointing at a legend is faster and less ambiguous than describing "the legend on the third chart" in words.

**How to use:**

* **Enter annotation mode**: click the annotation entry on the Canvas.
* **Select or circle a target**: click a specific element, or draw a freehand circle around a region.
* **Add a comment**: type your suggested changes or feedback on the annotation.
* **Send to the Agent**: the annotation is attached to the conversation as context; the Agent reads it, updates the Canvas source, and re-renders.

## Sharing

Canvas supports one-click publishing so you can share a canvas with your teammates. Published canvases are **visible only within your organization** — they are not exposed publicly.

<Note>
  Sharing is available on **Teams / Enterprise** plans only. Personal-plan users will see: *"Sharing is available on Teams and Enterprise plans. Join or create a team to share."*
</Note>

### Publish a Canvas

Click **Publish** in the Canvas toolbar to publish the current canvas to your organization.

* The publish popover shows *"All team members can view"* — confirm to complete publishing.
* The button then changes to **Published**, and teammates can open the canvas from the share link within your organization.

### After publishing

Click **Published** to open a dropdown menu:

| Action                    | Description                                                                                                                                               |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sync**                  | Sync the latest Canvas content to the published version. Shows a loading state while syncing; on success the timestamp updates to "Last synced just now". |
| **Copy link**             | Copy the share link to the clipboard so you can hand it to teammates.                                                                                     |
| **Unpublish**             | Revoke sharing. The original link stops working and the button reverts to **Publish**.                                                                    |
| **View published Canvas** | Open the enterprise admin console's shared list.                                                                                                          |

The menu also shows the last sync time, e.g. `Last synced 5 minutes ago`.

### My Shares

**My Shares** in the left navigation of the enterprise admin console collects everything you've shared from Qoder (currently just Canvas).

* **Entry**: Enterprise admin console → **My Shares** (hidden when you have no shared content).
* **Columns**: Canvas name, publish / last synced time.
* **Row actions**:
  * Click a Canvas name — preview the published canvas.
  * `...` menu on the right — **Copy link**, **Delete** (deletes canvases you published).