Telva Documentation

Technical documentation for integrating, controlling, and extending Telva in production apps.

Telva Documentation

Telva is a React drawing editor package (telva) built on top of a reusable rendering engine (telva-core) and geometry utilities (telva-vec, telva-intersect, telva-curve).

This documentation is focused on practical implementation:

  • integrate <Telva /> into different frontend contexts
  • control editor state with props or imperative APIs
  • build export and multiplayer workflows
  • extend the system with custom React components and custom shape utilities

Package map

PackagePurpose
telvaHigh-level embeddable editor component and app API
telva-coreLow-level renderer, shape util base class, pointer and event types
telva-vecVector math primitives for points, distances, and transforms
telva-intersectGeometry intersection/hit-testing helpers
telva-curveCurve and spline helpers for drawing/path tools

Suggested reading path

  1. Getting Started for install + first render
  2. Integration for real app patterns (Next.js, controlled mode, export, multiplayer)
  3. Reference for props, callbacks, and command APIs
  4. Extension for custom registry entries and shape utilities
  5. Operations for file workflows and troubleshooting

Source of truth

All examples and API notes in this documentation were derived from the current repository implementation:

  • packages/telva/src and packages/telva/dist/*.d.ts
  • packages/core/dist/*.d.ts
  • examples/telva-example/src
  • examples/core-example/src
  • examples/core-example-advanced/src

On this page