Diagram Types

Features & Tools

For Creatives

For Technical Teams

For Everyone

Resources

BlogPricing
Log in
Back to docs

User Guide

A complete reference for every Raltey feature: AI agent, integrations, documentation, exports, smart actions, and more.

12 min read

Diagram types

Raltey currently supports three diagram types, each with its own canvas and tooling:

TypeAvailable onBest for
FlowchartAll plansProcesses, decision trees, system logic
Mind MapStarter+Brainstorming, concept maps, hierarchies
Database DiagramPro+ERDs, schema design, SQL export

AI agent

The AI Hub is a chat sidebar built directly into the editor. To open it, click the sparkle icon in the toolbar.

What the agent can do

The agent has direct access to tools that modify your canvas:

  • update_diagram — add, edit, or remove nodes and connections
  • update_docs — write or update the project's documentation
  • create_project — create a new project from the conversation
  • read_project — read the contents of another project for context

@-mention cross-project references

In the AI Hub chat, type @ to bring up a list of your projects. Mentioning a project gives the agent its full context, so it can answer questions or generate content that spans multiple diagrams.

Image to diagram

Click the image icon in the editor toolbar to upload a photo, screenshot, or whiteboard picture. The agent analyzes the image and generates the corresponding nodes and connections on your canvas.

Mermaid import

If you have an existing Mermaid diagram definition, click the Mermaid import button in the toolbar (flowcharts only). Paste your Mermaid code and it will be converted to native Raltey nodes.

Quick actions

Select one or more nodes on the canvas and click the lightning bolt in the selection toolbar. Six one-click AI transforms appear without any prompting:

  1. Break down — split into sub-steps
  2. Simplify — reduce to core concept
  3. Add error handling — expand with error paths
  4. Suggest connections — propose missing links
  5. Summarize — condense group into one node
  6. Expand — grow into a full sub-diagram

Documentation

Every project has a built-in documentation editor (Tiptap rich text) accessible from the right-side panel.

AI documentation generation

With a diagram open, ask the AI agent: "Generate documentation for this diagram". The agent reads the canvas structure and writes structured documentation directly into the docs panel.

Multiple documents per project

Use the docs sidebar to create, rename, and switch between multiple documents in the same project. Each document is saved automatically.

Smart actions

You can attach an action to any flowchart node. Select a node and open the Smart Actions panel from the node toolbar.

Available actions:

ActionWhat it does
Open linkOpens a URL when the node is clicked (Figma, Jira, GitHub, etc.)
Copy textCopies a preset text to clipboard
Trigger webhookFires a POST request to a URL with the node's data
Navigate to projectOpens another Raltey project

Integrations

Connect external tools from the Integrations page in the main sidebar, or from the integration panel inside any project editor.

GitHub

Connect your GitHub account and import a repository's file tree directly as diagram nodes. Each node links back to the corresponding file on GitHub.

Linear

Connect Linear and import issues from a project as diagram nodes. Use this to visualize sprint work, track dependencies, or document workflows.

Notion

Connect Notion and import database entries as diagram nodes. Useful for mapping content plans, project trackers, or structured data.

All integration imports are manual — click "Sync" to pull the latest state from the connected tool.

Export

FormatAvailable on
PNGAll plans (Free adds watermark)
SVGStarter+
PDFPro+
SQL schemaPro+ (Database Diagrams only)

To export, click the download icon in the editor toolbar and select your format.

Presentation mode

Press the presentation button (monitor icon) in the editor toolbar to enter presentation mode. The canvas focuses on one node at a time and adds navigation controls. Use the arrow keys or on-screen buttons to step through nodes in order.

Presentation mode works on all diagram types — no extra configuration needed.

Sharing and collaboration

Click Share in the top-right to manage access:

  • Public link — a read-only shareable link (no login required for viewers)
  • Team access — invite members by email with view or edit permissions

On Pro plans, all editors see each other's live cursors and can leave threaded comments pinned to specific nodes.

Templates

Go to Templates in the main sidebar to browse the template library. Use the search bar or filter by category. Click any template to open it as a new project ready to edit.

Settings

From the main sidebar, open Settings to manage:

  • Profile — name, avatar, preferences
  • Teams — create or switch between teams, invite members, manage roles
  • Billing — view your current plan, upgrade, or manage your subscription via the billing portal