# Chhart

> A free, web-based diagram editor that turns simple text into flowcharts and Sankey diagrams. No account required—diagrams are shareable via URL.

Chhart uses an indentation-based DSL (write like an outline) and renders a diagram as you type.

## Quick Start

1. Open `https://chhart.app`
2. Paste or type diagram text (examples below)
3. Share via URL, export (PNG/SVG), or embed via iframe

## Diagram DSL (Minimal Examples)

### Flowchart

Indentation creates connections (parent → child). Add attributes in square brackets.

```
Start
  Check input [shape=diamond]
    Valid
      Process
      End [bg=green]
    Invalid
      Show error [bg=red]
```

### Sankey

Use `[value=N]` on child lines to define weighted flows.

```
Revenue
  [value=60] Profit
  [value=40] Costs
```

## Share URL Format (Canonical)

Diagrams are encoded in the URL hash:

- Flowchart: `https://chhart.app/#flowchart=<base64url>&title=<title>`
- Sankey: `https://chhart.app/#sankey=<base64url>&title=<title>`

## Embed URL (Optional Parameters)

Embed is controlled via hash parameters:

- `embed=1` enables embed mode
- `theme=light|dark` sets embed theme
- `toolbar=1` shows an embed toolbar

Example: `https://chhart.app/#flowchart=<base64url>&embed=1&theme=dark&toolbar=1`

## Gotchas (Important)

- The full diagram text is encoded in the URL. Treat shared links as public.
- Very large diagrams can produce very long URLs that some chat apps may truncate.

## MCP Integration (For AI Assistants)

- Endpoint: `https://mcp.chhart.app/mcp`
- Tools: `create_flowchart`, `create_sankey`, `get_syntax_help`

## Links

- Full spec: `https://chhart.app/llms-full.txt`
- App: `https://chhart.app`
- Blog & changelog: `https://hub.chhart.app`