Installation

Pre-1.0

Morphic Blocks is published and ready to try. It is still before 1.0, so the public API may change between minor versions.

Morphic Blocks bundles Blockly as a dependency, so it is installed for you:

npm

npm install morphic-blocks

bun

bun add morphic-blocks

pnpm

pnpm add morphic-blocks

Optional: code editor packages

The code editor, codespace, and preview views are built on CodeMirror 6. The CodeMirror packages are optional peer dependencies — install them only if you use those views:

npm

npm install @codemirror/state @codemirror/view @codemirror/lang-javascript

bun

bun add @codemirror/state @codemirror/view @codemirror/lang-javascript

pnpm

pnpm add @codemirror/state @codemirror/view @codemirror/lang-javascript

They are loaded lazily: a project that never mounts a code editor never pays for them.

Requirements

• A bundler-based setup (Vite, or anything that resolves modern ESM). The library ships ES modules plus TypeScript declarations.
• TypeScript is recommended — the public API is fully typed — but not required.

Next: the Quick Start.