canvas

---
name: canvas
description: Create or update a Routa Canvas artifact for the current task. Use when the user wants a live visual or interactive canvas generated from a Routa session.
metadata:
  short-description: Create a Routa Canvas artifact
---

Use Routa Canvas for this turn.

Canvas behavior:
- Create or overwrite exactly one `*.canvas.tsx` file during the tool run.
- The file content must be the TSX source itself, not markdown.
- Prefer storing the file under the selected repository when appropriate.
- Use a short descriptive file name ending in `.canvas.tsx`.
- After the file is created, mention the created path briefly.

Source contract:
- Create a Routa browser canvas as TSX source code.
- Return only the TSX source.
- Do not include markdown code fences.
- Do not include explanations, notes, or prose before or after the code.
- The source must `export default function Canvas()` or `export default Canvas`.
- Prefer a self-contained component with inline styles.
- If you import anything, you may only import from `react`, `routa/canvas`, `routa/canvas/*`, `@canvas-sdk`, or `@canvas-sdk/*`.
- Do not use browser globals or side effects such as `window`, `document`, `fetch`, or `localStorage`.
- Do not render fake shell chrome such as `browser frames`, `global app shells`, `left sidebars`, or `chat panes` unless the prompt explicitly asks for it.
- Keep the composition flat, minimal, purposeful; avoid gradients, emojis, box shadows.

Canvas SDK access:
- Prefer MCP tool `read_canvas_sdk_resource` with uri `resource://routa/canvas-sdk/manifest`.
- If your provider supports native MCP resource reads, you may read that same URI directly instead.
- That manifest is the authoritative Canvas SDK index for this session.
- Then read only the defs resources you actually need from its `definitionResources` list, preferably through `read_canvas_sdk_resource`.
- Import only from `routa/canvas` or `react`.
- If a symbol or prop is not present in those resources, do not invent it.
- Example definition resources:
- `resource://routa/canvas-sdk/defs/primitives`
- `resource://routa/canvas-sdk/defs/hooks`
- `resource://routa/canvas-sdk/defs/data-display`
- `resource://routa/canvas-sdk/defs/containers`
- `resource://routa/canvas-sdk/defs/controls`
- `resource://routa/canvas-sdk/defs/charts`
- `resource://routa/canvas-sdk/defs/diff-view`
- `resource://routa/canvas-sdk/defs/dag-layout`
- If neither direct resource reads nor the helper tool are available, stay conservative and use only the symbols named in the manifest.

More agent context in phodal/routa

13 other files this repository gives its agents.