Skip to content
Back to search

grethel-labs

MarketplaceWorks with Claude CodeGitHub

Plugins by grethel-labs

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/grethel-labs--excaliplant/badge.svg)](/listings/grethel-labs--excaliplant)

HTML

<a href="/listings/grethel-labs--excaliplant"><img src="/api/listings/grethel-labs--excaliplant/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install @grethel-labs/excaliplant

Command line

npx excaliplant diagram.puml -o diagram.svg          # hand-drawn SVG
npx excaliplant diagram.puml -o diagram.png --width 1600
npx excaliplant diagram.puml -o diagram.excalidraw   # open in excalidraw.com
cat diagram.puml | npx excaliplant -f svg --theme dark > diagram.svg

JavaScript

import { render } from "@grethel-labs/excaliplant";

const result = await render(`
@startuml
Alice -> Bob : hello
Bob --> Alice : hi!
@enduml
`);

result.kind; //           "sequence"
result.excalidraw; //     Excalidraw scene (JSON)
await result.toSvg(); //  standalone SVG with embedded Excalifont
await result.toPng({ width: 1200 }); // PNG Buffer
result.diagnostics; //    warnings with line numbers

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "grethel-labs",
  3. "description": "Plugins by grethel-labs",
  4. "owner": {
  5. "name": "grethel-labs"
  6. },
  7. "plugins": [
  8. {
  9. "name": "excaliplant",
  10. "source": "./integrations/claude-plugin",
  11. "description": "Render PlantUML as hand-drawn Excalidraw, SVG and PNG diagrams. Bundles the excaliplant agent skill.",
  12. "homepage": "https://github.com/grethel-labs/excaliplant#readme",
  13. "license": "MIT",
  14. "keywords": ["plantuml", "excalidraw", "diagram", "uml"]
  15. }
  16. ]
  17. }
README.md · README · 280 lines
  1. <!-- This README is generated by `npm run docs` from docs/README.template.md. Edit the template, not this file. -->
  2. <h1 align="center">excaliplant</h1>
  3. <p align="center">
  4. <b>PlantUML in, hand-drawn diagrams out.</b><br />
  5. Render PlantUML as editable <a href="https://excalidraw.com">Excalidraw</a> scenes, SVG and PNG — 29 diagram types, zero Java, zero network.
  6. </p>
  7. <p align="center">
  8. <b><a href="https://grethel-labs.github.io/excaliplant/#play">▶ Try it live — write PlantUML in your browser</a></b><br />
  9. <sub>Live preview, every render option, all 41 examples open and editable, share by link, export SVG, PNG or Excalidraw.</sub>
  10. </p>
  11. <p align="center">
  12. <a href="https://www.npmjs.com/package/@grethel-labs/excaliplant"><img src="https://img.shields.io/npm/v/@grethel-labs/excaliplant.svg?label=npm" alt="npm version" /></a>
  13. <a href="https://www.npmjs.com/package/@grethel-labs/excaliplant"><img src="https://img.shields.io/npm/dm/@grethel-labs/excaliplant.svg" alt="downloads" /></a>
  14. <a href="https://github.com/grethel-labs/excaliplant/actions/workflows/ci.yml"><img src="https://github.com/grethel-labs/excaliplant/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
  15. <img src="https://img.shields.io/node/v/@grethel-labs/excaliplant.svg" alt="node" />
  16. <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@grethel-labs/excaliplant.svg" alt="MIT license" /></a>
  17. </p>
  18. <p align="center">
  19. <a href="https://grethel-labs.github.io/excaliplant/#gallery"><img src="docs/assets/carousel.svg" alt="Animated showcase of excaliplant diagram types" width="100%" /></a>
  20. </p>
  21. <p align="center">
  22. <a href="https://grethel-labs.github.io/excaliplant/#gallery/sequence"><kbd>Sequence</kbd></a>
  23. <a href="https://grethel-labs.github.io/excaliplant/#gallery/class"><kbd>Class & IE</kbd></a>
  24. <a href="https://grethel-labs.github.io/excaliplant/#gallery/activity"><kbd>Activity</kbd></a>
  25. <a href="https://grethel-labs.github.io/excaliplant/#gallery/state"><kbd>State</kbd></a>
  26. <a href="https://grethel-labs.github.io/excaliplant/#gallery/component"><kbd>Component & C4</kbd></a>
  27. <a href="https://grethel-labs.github.io/excaliplant/#gallery/usecase"><kbd>Use case</kbd></a>
  28. <a href="https://grethel-labs.github.io/excaliplant/#gallery/deployment"><kbd>Deployment</kbd></a>
  29. <a href="https://grethel-labs.github.io/excaliplant/#gallery/object"><kbd>Object</kbd></a>
  30. <a href="https://grethel-labs.github.io/excaliplant/#gallery/timing"><kbd>Timing</kbd></a>
  31. <a href="https://grethel-labs.github.io/excaliplant/#gallery/gantt"><kbd>Gantt</kbd></a>
  32. <a href="https://grethel-labs.github.io/excaliplant/#gallery/mindmap"><kbd>Mind map</kbd></a>
  33. <a href="https://grethel-labs.github.io/excaliplant/#gallery/wbs"><kbd>WBS</kbd></a>
  34. <a href="https://grethel-labs.github.io/excaliplant/#gallery/json"><kbd>JSON</kbd></a>
  35. <a href="https://grethel-labs.github.io/excaliplant/#gallery/yaml"><kbd>YAML</kbd></a>
  36. <a href="https://grethel-labs.github.io/excaliplant/#gallery/archimate"><kbd>ArchiMate</kbd></a>
  37. <a href="https://grethel-labs.github.io/excaliplant/#gallery/chen"><kbd>Chen ER</kbd></a>
  38. <a href="https://grethel-labs.github.io/excaliplant/#gallery/nwdiag"><kbd>Network</kbd></a>
  39. <a href="https://grethel-labs.github.io/excaliplant/#gallery/salt"><kbd>Salt wireframe</kbd></a>
  40. <a href="https://grethel-labs.github.io/excaliplant/#gallery/ebnf"><kbd>EBNF</kbd></a>
  41. <a href="https://grethel-labs.github.io/excaliplant/#gallery/regex"><kbd>Regex</kbd></a>
  42. <a href="https://grethel-labs.github.io/excaliplant/#gallery/dot"><kbd>Graphviz DOT</kbd></a>
  43. <a href="https://grethel-labs.github.io/excaliplant/#gallery/chronology"><kbd>Chronology</kbd></a>
  44. <a href="https://grethel-labs.github.io/excaliplant/#gallery/files"><kbd>Files</kbd></a>
  45. <a href="https://grethel-labs.github.io/excaliplant/#gallery/chart"><kbd>Chart</kbd></a>
  46. <a href="https://grethel-labs.github.io/excaliplant/#gallery/math"><kbd>AsciiMath</kbd></a>
  47. <a href="https://grethel-labs.github.io/excaliplant/#gallery/latex"><kbd>LaTeX</kbd></a>
  48. <a href="https://grethel-labs.github.io/excaliplant/#gallery/ditaa"><kbd>Ditaa</kbd></a>
  49. <a href="https://grethel-labs.github.io/excaliplant/#gallery/legacy-activity"><kbd>Legacy activity</kbd></a>
  50. <a href="https://grethel-labs.github.io/excaliplant/#gallery/creole"><kbd>Creole</kbd></a>
  51. </p>
  52. <p align="center">
  53. <sub>Every diagram is rendered by excaliplant from <a href="examples/"><code>examples/</code></a> — with PlantUML source, SVG and <code>.excalidraw</code> downloads in the gallery.</sub>
  54. </p>
  55. ## Why excaliplant?
  56. - **Looks like a whiteboard, stays a diagram.** Output is a real Excalidraw scene: open it in Excalidraw, move boxes, arrows stay bound.
  57. - **Broad PlantUML coverage.** Sequence, class, activity, state, component, C4, Gantt, mind maps, JSON, regex, math — see the [full list](#supported-diagrams).
  58. - **The PlantUML language, not just diagrams.** Preprocessor (`!procedure`, `!function`, loops, JSON variables, `!include`), Creole markup, `skinparam`, `<style>`, themes, colours and bundled C4/ArchiMate libraries.
  59. - **Pure JavaScript.** No Java, no Graphviz, no PlantUML server. Layout runs on [ELK](https://github.com/kieler/elkjs) and purpose-built engines.
  60. - **Deterministic.** Same input, same bytes — ideal for docs in git.
  61. - **Safe for untrusted input.** Resource limits, escaped output, no file or network access unless you opt in.
  62. ## Quick start
  63. ```sh
  64. npm install @grethel-labs/excaliplant
  65. ```
  66. ### Command line
  67. ```sh
  68. npx excaliplant diagram.puml -o diagram.svg # hand-drawn SVG
  69. npx excaliplant diagram.puml -o diagram.png --width 1600
  70. npx excaliplant diagram.puml -o diagram.excalidraw # open in excalidraw.com
  71. cat diagram.puml | npx excaliplant -f svg --theme dark > diagram.svg
  72. ```
  73. ### JavaScript
  74. ```js
  75. import { render } from "@grethel-labs/excaliplant";
  76. const result = await render(`
  77. @startuml
  78. Alice -> Bob : hello
  79. Bob --> Alice : hi!
  80. @enduml
  81. `);
  82. result.kind; // "sequence"
  83. result.excalidraw; // Excalidraw scene (JSON)
  84. await result.toSvg(); // standalone SVG with embedded Excalifont
  85. await result.toPng({ width: 1200 }); // PNG Buffer
  86. result.diagnostics; // warnings with line numbers
  87. ```
  88. ## Use it everywhere
  89. One package, several front doors. Everything is built from this repository and released together with the npm package.
  90. | Where | What | Docs |
  91. | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
  92. | Markdown | `excaliplant markdown README.md` replaces ` ```plantuml ` blocks with diagrams; plugins for `markdown-it` and `remark`; a GitHub Action for CI | [`docs/markdown.md`](docs/markdown.md) |
  93. | AI assistants | An agent skill for Claude Code, Claude, Codex, Gemini CLI, opencode, Cursor, Copilot, Antigravity and more (`excaliplant skills install`), always bundled with the current Excalidraw element spec | [`docs/skills.md`](docs/skills.md) |
  94. | MCP clients | `excaliplant mcp` — an MCP server with `render_plantuml`, `validate_plantuml`, `list_diagram_types` and `get_example` | [`docs/mcp.md`](docs/mcp.md) |
  95. | VS Code | Live Markdown preview and commands for `.puml` files | [`docs/vscode.md`](docs/vscode.md) |
  96. | Obsidian | Renders `plantuml` code blocks in your notes | [`docs/obsidian.md`](docs/obsidian.md) |
  97. | Directories | Where excaliplant is listed (Claude, Codex, Gemini CLI, skills.sh, MCP registry, Markdown ecosystems) and how to submit it | [`docs/publishing.md`](docs/publishing.md) |
  98. ## How it works
  99. <img src="docs/assets/pipeline.png" alt="excaliplant pipeline" />
  100. Each diagram type is a small module with four hooks — `detect`, `parse`, `layout`, `draw` — on top of a shared core (preprocessor, PlantUML syntax helpers, text measurement with real font metrics, a drawing canvas and the renderers). Modules never touch Excalidraw or SVG directly; they draw shapes on a canvas, which keeps the three output formats in sync. See [`docs/architecture.md`](docs/architecture.md).
  101. ## Supported diagrams
  102. | Diagram | Examples | Highlights |
  103. | --- | --- | --- |
  104. | [Sequence](https://grethel-labs.github.io/excaliplant/#gallery/sequence) | [4](docs/gallery.md#sequence) | Participants, all arrow styles, activations, notes, fragments, dividers, autonumber, boxes. |
  105. | [Class & IE](https://grethel-labs.github.io/excaliplant/#gallery/class) | [3](docs/gallery.md#class) | Classes, interfaces, enums, generics, members, packages, all UML relations, IE crow's feet. |
  106. | [Activity](https://grethel-labs.github.io/excaliplant/#gallery/activity) | [3](docs/gallery.md#activity) | New syntax with if/switch/while/repeat/fork/split, partitions, notes and swimlanes. |
  107. | [State](https://grethel-labs.github.io/excaliplant/#gallery/state) | [2](docs/gallery.md#state) | Composite states, concurrent regions, choice, fork/join, history, entry/exit actions. |
  108. | [Component & C4](https://grethel-labs.github.io/excaliplant/#gallery/component) | [2](docs/gallery.md#component) | Components, interfaces, ports, packages, nodes — and C4 via `!include <C4/...>`. |
  109. | [Use case](https://grethel-labs.github.io/excaliplant/#gallery/usecase) | [2](docs/gallery.md#usecase) | Actors, use cases, system boundaries, include/extend. |
  110. | [Deployment](https://grethel-labs.github.io/excaliplant/#gallery/deployment) | [2](docs/gallery.md#deployment) | Nodes, clouds, databases, queues, artifacts and nested deployment targets. |
  111. | [Object](https://grethel-labs.github.io/excaliplant/#gallery/object) | [1](docs/gallery.md#object) | Objects with fields, maps (`key => value`) and links. |
  112. | [Timing](https://grethel-labs.github.io/excaliplant/#gallery/timing) | [2](docs/gallery.md#timing) | Robust, concise, clock, binary and analog signals with messages and constraints. |
  113. | [Gantt](https://grethel-labs.github.io/excaliplant/#gallery/gantt) | [1](docs/gallery.md#gantt) | Tasks, dependencies, milestones, progress, resources, closed days, today marker. |
  114. | [Mind map](https://grethel-labs.github.io/excaliplant/#gallery/mindmap) | [1](docs/gallery.md#mindmap) | OrgMode/Markdown outlines on both sides, colours, boxless nodes. |
  115. | [WBS](https://grethel-labs.github.io/excaliplant/#gallery/wbs) | [1](docs/gallery.md#wbs) | Work breakdown structures as org charts. |
  116. | [JSON](https://grethel-labs.github.io/excaliplant/#gallery/json) | [1](docs/gallery.md#json) | JSON documents as linked tables with highlights. |
  117. | [YAML](https://grethel-labs.github.io/excaliplant/#gallery/yaml) | [1](docs/gallery.md#yaml) | YAML documents as linked tables. |
  118. | [ArchiMate](https://grethel-labs.github.io/excaliplant/#gallery/archimate) | [1](docs/gallery.md#archimate) | ArchiMate elements by layer with icons, junctions and `Rel_*` macros. |
  119. | [Chen ER](https://grethel-labs.github.io/excaliplant/#gallery/chen) | [1](docs/gallery.md#chen) | Chen ER diagrams: entities, weak entities, relationships, attributes, cardinalities. |
  120. | [Network](https://grethel-labs.github.io/excaliplant/#gallery/nwdiag) | [1](docs/gallery.md#nwdiag) | Networks, addresses, multi-homed nodes, groups and peer links. |
  121. | [Salt wireframe](https://grethel-labs.github.io/excaliplant/#gallery/salt) | [1](docs/gallery.md#salt) | Wireframes: grids, buttons, inputs, check boxes, trees, tabs, group boxes. |
  122. | [EBNF](https://grethel-labs.github.io/excaliplant/#gallery/ebnf) | [1](docs/gallery.md#ebnf) | EBNF grammars as railroad diagrams. |
  123. | [Regex](https://grethel-labs.github.io/excaliplant/#gallery/regex) | [1](docs/gallery.md#regex) | Regular expressions as railroad diagrams. |
  124. | [Graphviz DOT](https://grethel-labs.github.io/excaliplant/#gallery/dot) | [1](docs/gallery.md#dot) | Graphviz DOT graphs laid out with ELK. |
  125. | [Chronology](https://grethel-labs.github.io/excaliplant/#gallery/chronology) | [1](docs/gallery.md#chronology) | Events and spans on a time line with links. |
  126. | [Files](https://grethel-labs.github.io/excaliplant/#gallery/files) | [1](docs/gallery.md#files) | File trees from path lists with notes. |
  127. | [Chart](https://grethel-labs.github.io/excaliplant/#gallery/chart) | [1](docs/gallery.md#chart) | Bar, line, area and scatter charts. |
  128. | [AsciiMath](https://grethel-labs.github.io/excaliplant/#gallery/math) | [1](docs/gallery.md#math) | AsciiMath formulas. |
  129. | [LaTeX](https://grethel-labs.github.io/excaliplant/#gallery/latex) | [1](docs/gallery.md#latex) | LaTeX formulas. |
  130. | [Ditaa](https://grethel-labs.github.io/excaliplant/#gallery/ditaa) | [1](docs/gallery.md#ditaa) | ASCII art boxes, lines, arrows and colour tags. |
  131. | [Legacy activity](https://grethel-labs.github.io/excaliplant/#gallery/legacy-activity) | [1](docs/gallery.md#legacy-activity) | The classic `(*) --> "Activity"` syntax with sync bars and branches. |
  132. | [Creole](https://grethel-labs.github.io/excaliplant/#gallery/creole) | [1](docs/gallery.md#creole) | Rich text with headings, lists, tables and links. |
  133. ## PlantUML language support
  134. | Feature | Notes |
  135. | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  136. | Preprocessor | `!$var`, `!define`/`!definelong`, `!if`/`!elseif`/`!else`, `!ifdef`, `!while`, `!foreach`, `!procedure`, `!function`/`!return`, default and keyword arguments, JSON variables, builtins (`%strlen`, `%upper`, `%date`, `%lighten`, …), `!include`/`!includesub` via resolver, `!theme`, `!pragma`, `!log`, `!assert` |
  137. | Standard library | Bundled, offline implementations of `<C4/C4_Context>`, `<C4/C4_Container>`, `<C4/C4_Component>`, … and `<archimate/Archimate>` |
  138. | Creole | `**bold**`, `//italic//`, `""mono""`, `--strike--`, `__underline__`, `~~wave~~`, headings, bullet and numbered lists, tables, separators, `<b>`, `<i>`, `<color>`, `<size>`, `<back>`, `<sub>`, `<sup>`, `[[links]]`, `<U+XXXX>` |
  139. | Styling | `skinparam` (single line and blocks), `<style>` sheets, inline colours `#back;line:red;line.dashed;text:blue`, all HTML colour names, gradients (first colour) |
  140. | Commons | `title`, `caption`, `header`, `footer`, `legend`, `mainframe`, `hide`/`show`, `left to right direction`, `newpage`, multiple `@start…@end` blocks |
  141. ## Themes
  142. Pick a theme with `--theme` / `{ theme }`, or let PlantUML's `!theme` choose the closest match. Available: `sketch`, `plain`, `hachure`, `mono`, `dark`, `blueprint`. Add `--clean` / `{ sketch: false }` for straight lines.
  143. <table>
  144. <tr>
  145. <td align="center"><img src="docs/assets/theme-sketch.png" width="250" alt="sketch theme" /><br /><code>sketch</code></td>
  146. <td align="center"><img src="docs/assets/theme-plain.png" width="250" alt="plain theme" /><br /><code>plain</code></td>
  147. <td align="center"><img src="docs/assets/theme-hachure.png" width="250" alt="hachure theme" /><br /><code>hachure</code></td>
  148. </tr>
  149. <tr>
  150. <td align="center"><img src="docs/assets/theme-mono.png" width="250" alt="mono theme" /><br /><code>mono</code></td>
  151. <td align="center"><img src="docs/assets/theme-dark.png" width="250" alt="dark theme" /><br /><code>dark</code></td>
  152. <td align="center"><img src="docs/assets/theme-blueprint.png" width="250" alt="blueprint theme" /><br /><code>blueprint</code></td>
  153. </tr>
  154. </table>
  155. ## API
  156. | Export | Description |
  157. | ----------------------------------------- | ----------------------------------------------------------------- |
  158. | `render(source, options?)` | Render the first (or `options.block`) diagram → `RenderResult` |
  159. | `renderAll(source, options?)` | Render every `@start…@end` block |
  160. | `parse(source, options?)` | Parse without layout → `{ kind, model, diagnostics }` |
  161. | `detectKind(source)` | Detected diagram kind |
  162. | `listDiagramTypes()` | Supported kinds and their start keywords |
  163. | `renderPlantUml(source)` | 0.x-compatible: `await` → Excalidraw JSON, `.toSvg()`, `.toPng()` |
  164. | `preprocessText(source, options?)` | Run only the preprocessor |
  165. | `DiagramRegistry`, `defineDiagram` | Register your own diagram modules |
  166. | `THEMES`, `THEME_NAMES`, `DEFAULT_LIMITS` | Built-in themes and resource limits |
  167. `RenderResult` has `kind`, `name`, `excalidraw`, `diagnostics`, `pages`, `model`, `toJSON()`, `toSvg({ padding, background, embedFont })` and `toPng({ width, scale, background })`.
  168. <details>
  169. <summary><b>Render options</b></summary>
  170. | Option | Default | Description |
  171. | ---------- | ---------------- | ------------------------------------------------------------------------- |
  172. | `theme` | `"sketch"` | Theme name or theme object |
  173. | `sketch` | theme default | `false` for clean strokes |
  174. | `seed` | `"excaliplant"` | Seed for ids and stroke wobble |
  175. | `block` | `0` | Block index or `@startuml name` |
  176. | `page` | `0` | Page of a `newpage` document |
  177. | `strict` | `false` | Throw on unrecognised lines instead of warning |
  178. | `include` | — | `(target, { from, kind }) => string \| null` resolver for `!include` |
  179. | `defines` | — | Predefined preprocessor variables |
  180. | `date` | `null` | Date returned by `%date()` (empty by default for reproducible output) |
  181. | `limits` | `DEFAULT_LIMITS` | Input size, lines, nodes, edges, elements, preprocessor budget, PNG width |
  182. | `kind` | auto | Force a diagram module |
  183. | `registry` | built-in | Custom `DiagramRegistry` |
  184. </details>
  185. <details>
  186. <summary><b>CLI options</b></summary>
  187. ```text
  188. excaliplant [input.puml] [-o output] [options]
  189. -o, --output <file> Output file (format from extension unless -f is given)
  190. -f, --format <fmt> excalidraw | svg | png
  191. -t, --theme <name> sketch | plain | hachure | mono | dark | blueprint
  192. --clean Clean strokes instead of the hand-drawn look
  193. --width <px> PNG width (16–16000)
  194. --scale <n> PNG scale relative to the SVG size (default 2)
  195. --background <color> Background colour for SVG/PNG
  196. --seed <value> Seed for stroke wobble and element ids
  197. --page <n> Page of a newpage document
  198. --all Render every block ("{n}" in -o is the block number)
  199. --include-dir <dir> Allow !include of files below <dir>
  200. -D, --define NAME=value Predefine a preprocessor variable
  201. --strict Fail on unrecognised lines
  202. --list-types List supported diagram types
  203. ```
  204. </details>
  205. ## Security
  206. excaliplant is built to render untrusted PlantUML:
  207. - No file-system or network access while rendering. `!include` only works through a resolver you pass in (the CLI's `--include-dir` restricts includes to one directory tree); `!includeurl` and `!import` are refused.
  208. - Every text and attribute in SVG output is escaped; colours are validated; links are limited to `http(s)` and `mailto`.
  209. - Budgets for input size, lines, preprocessor steps/recursion/loop iterations, nodes, edges, drawing elements and PNG size (see `DEFAULT_LIMITS`).
  210. - Parsers are scanner-based or use bounded regular expressions; hostile inputs are covered by [`test/security.test.mjs`](test/security.test.mjs).
  211. Please report vulnerabilities as described in [SECURITY.md](SECURITY.md).
  212. ## Compatibility notes
  213. excaliplant re-implements PlantUML in JavaScript, so diagrams look different from PlantUML's output — that is the point. Layout decisions differ (ELK instead of Graphviz), sprites and `<&icons>` render as placeholder glyphs, and the bundled standard library covers C4 and ArchiMate only. Unknown lines are reported as warnings (or errors with `strict`), never silently dropped.
  214. ## Development
  215. ```sh
  216. npm ci
  217. npm test # node:test suite (examples, syntax, security, CLI)
  218. npm run typecheck # tsc --checkJs
  219. npm run format # prettier
  220. npm run docs # regenerate gallery, screenshots and this README
  221. npm run check # everything CI checks
  222. ```
  223. Add a diagram example by dropping a `.puml` file into `examples/<kind>/` — it becomes a test case and a gallery entry. Contribution guidelines live in [CONTRIBUTING.md](CONTRIBUTING.md).
  224. Releases are fully automated: every pull request carries one `release:major|minor|patch|none` label, and merging publishes the next version to npm with provenance (see [`docs/releasing.md`](docs/releasing.md)).
  225. ## License
  226. [MIT](LICENSE). Excalifont is licensed under the SIL Open Font License; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
  227. > **AI-generated project notice:** this repository was created almost entirely with AI assistance. Review the code before relying on it; the MIT warranty disclaimer applies.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.