Plots & Files

Once you have created a plot, this page covers how to add content, browse files, and manage your plots.

Add Content to a Plot

Open a plot and click the Add item dropdown in the toolbar. You get three options.

Upload File

Opens your system file picker with multi-select enabled. Supported types include PDF, text, markdown, code files (JS, TS, JSON, HTML, CSS), and images (PNG, JPG, GIF, WebP, SVG). Max file size is 10 MB per file.

Add Folder

Opens a multi-step directory upload wizard:

  1. Select a project directory from your filesystem.
  2. Choose whether to respect .gitignore rules (recommended).
  3. Preview what will be uploaded: source files, symlinked directories, and ignored files.
  4. Watch the upload progress bar with a file count.
  5. Review the completion summary.

The wizard uses hybrid storage. Source files go to cloud storage, while dependency directories like node_modules are symlinked from your local filesystem.

Type or Paste Content

Opens a dialog where you enter a title and paste or type text content directly. Good for notes, snippets, or reference material that does not live in a file.

Drag and Drop

You can also drag files from your desktop or file manager directly onto the plot detail page. A drop overlay appears when files hover over the page. Release to start the upload immediately.

Browse and Manage Files

The plot detail page shows all content in two view modes, toggled from the toolbar:

  • Tile view. A responsive grid of file cards showing icon, name, and size.
  • List view. Vertical rows with icon, name, size, and upload date.

Hover over any file to reveal a menu with these actions:

  • Preview. Opens a modal with type-aware rendering. Text and code files show formatted content. Mermaid files render as diagrams. PDFs embed in an iframe. Images display inline.
  • Edit (text content only). Opens the preview in edit mode so you can update the title and body.
  • Download. Saves the file to your computer.
  • Delete. Shows a confirmation dialog, then removes the file permanently.

Project Plots

If a plot was created by uploading a folder (the Add Folder wizard), the detail page shows an extra Project Summary section at the top with high-level stats: total file count, source file count, ignored files, and any symlinked dependency directories. Use this to confirm the upload captured everything you expected before specialists reference it.

Manage Plots

From the sidebar context menu or the plot detail page menu:

  • Rename. Opens the edit dialog to change the name and icon. The plot type stays locked.
  • Duplicate. Creates a full copy and navigates to it.
  • Copy to Workspace (personal plots only). Makes the plot available to everyone. Confirmation required.
  • Delete. Permanently removes the plot and all its content. This cannot be undone.