Back to Hub
Workbench Documentation

How to Use TypeMorph.

Welcome to the developer documentation. TypeMorph is a 100% local-first, privacy-respecting schema engineering workbench.

1. Quick Start Guide

Using TypeMorph is straightforward. The workbench operates on a dual-pane editor system:

  • Input Pane (Left): Paste your raw data or schemas (JSON payloads, SQL DDL dumps, cURL commands, CSV, XML, etc.).
  • Output Pane (Right): Instantly view strongly-typed generated outputs. Use the top tab bar to switch output targets dynamically (TypeScript, Zod, Rust, Go, SQL, Python, etc.).

2. Interactive Relationship Graph Editor

When converting complex nesting structures (like JSON to TypeScript/Zod), the engine compiles the schema into an abstract AST and visualizes it inside the Graph tab.

Pro-Tip: Direct Schema Editing
You can click directly on any field name inside the interactive node graph to rename it. Once you press Enter, the change propagates dynamically and instantly rewrites the output code in all generated programming languages and schemas (TypeScript, Go, Prisma, Rust, SQL, etc.).

3. Refactoring with "Explainable Logic"

If you paste a payload containing nested, repeated object structures, our AST engine automatically detects structural unification candidates:

  • Unification: The engine automatically merges structurally identical sub-objects into a single shared type (e.g. SharedUser) to keep your code DRY.
  • Split / Customize: If you do not want them unified, click the Decisions banner above the output code to Split them back into distinct custom structures or manually rename the extracted types.

4. Privacy & Local Processing

TypeMorph is built around complete data sovereignty:

  • 100% Client-Side Processing: All parsing, compilation, and output generation runs locally in your browser. No schema content is ever sent to our servers.
  • URL Import: You can load schemas directly from a public URL. If a URL is blocked by CORS, you can opt in to fetch it through our Cloudflare Worker proxy — but this is never done silently.

5. Schema Change Impact

The Impact tab (accessible via the "More" menu in the output panel) lets you compare two versions of a JSON structure and see exactly what breaks.

  • Paste your Before JSON and After JSON side by side.
  • Click Analyze Impact. TypeMorph traces the change through every class in the type graph and color-codes the result: changed (red), impacted (orange), safe (gray).
  • The language grid shows which of the 15 output targets need to be regenerated. Everything runs locally — no data is sent to any server.

6. PWA (Progressive Web App) Offline Mode

TypeMorph can be installed directly onto your OS. On supported browsers (desktop Chrome and Edge), an Install App button appears in the top navigation. Once installed, it works completely offline, making it a permanent local development tool on your workstation.

Last Updated: June 2026