Create and update shapes with complete control
Create and update shapes with automatic handling of positioning, parenting, and batch operations, even in complex scenarios.
Key features
Key features
Key features
Key features
Partial updates
Shape properties with partial objects that merge with existing data. Perfect for building reactive applications where shapes respond to data changes or user interactions.
Partial updates
Shape properties with partial objects that merge with existing data. Perfect for building reactive applications where shapes respond to data changes or user interactions.
Partial updates
Shape properties with partial objects that merge with existing data. Perfect for building reactive applications where shapes respond to data changes or user interactions.
Partial updates
Shape properties with partial objects that merge with existing data. Perfect for building reactive applications where shapes respond to data changes or user interactions.
Type-safe creation
Create shapes programmatically with automatic IDs, parent detection, and property validation. The system applies editor styles and keeps layer ordering consistent.
Type-safe creation
Create shapes programmatically with automatic IDs, parent detection, and property validation. The system applies editor styles and keeps layer ordering consistent.
Type-safe creation
Create shapes programmatically with automatic IDs, parent detection, and property validation. The system applies editor styles and keeps layer ordering consistent.
Type-safe creation
Create shapes programmatically with automatic IDs, parent detection, and property validation. The system applies editor styles and keeps layer ordering consistent.
Coordinate transforms
Automatic coordinate space conversion between page, parent, and local coordinates. Build applications that position shapes precisely without manual transform calculations.
Coordinate transforms
Automatic coordinate space conversion between page, parent, and local coordinates. Build applications that position shapes precisely without manual transform calculations.
Coordinate transforms
Automatic coordinate space conversion between page, parent, and local coordinates. Build applications that position shapes precisely without manual transform calculations.
Coordinate transforms
Automatic coordinate space conversion between page, parent, and local coordinates. Build applications that position shapes precisely without manual transform calculations.
Smart parenting
Automatic parent detection based on shape positioning and containment rules. Shapes find appropriate containers while respecting type compatibility and hierarchy constraints.
Smart parenting
Automatic parent detection based on shape positioning and containment rules. Shapes find appropriate containers while respecting type compatibility and hierarchy constraints.
Smart parenting
Automatic parent detection based on shape positioning and containment rules. Shapes find appropriate containers while respecting type compatibility and hierarchy constraints.
Smart parenting
Automatic parent detection based on shape positioning and containment rules. Shapes find appropriate containers while respecting type compatibility and hierarchy constraints.
Shape complexity, solved
APIs handle positioning and transforms so your canvas apps stay reactive and predictable.
Shape complexity, solved
APIs handle positioning and transforms so your canvas apps stay reactive and predictable.
Shape complexity, solved
APIs handle positioning and transforms so your canvas apps stay reactive and predictable.
Shape complexity, solved
APIs handle positioning and transforms so your canvas apps stay reactive and predictable.
Engineering details
Engineering details
Engineering details
Engineering details
Automatic parent detection
The creation system processes shapes through validation, parent assignment, coordinate transformation, and property merging. Shapes receive auto-generated IDs if none are provided, determine their parents based on position and containment rules, and are placed at the correct z-index in the hierarchy. Current editor styles are applied automatically, with type-specific properties validated through shape utilities.
Automatic parent detection
The creation system processes shapes through validation, parent assignment, coordinate transformation, and property merging. Shapes receive auto-generated IDs if none are provided, determine their parents based on position and containment rules, and are placed at the correct z-index in the hierarchy. Current editor styles are applied automatically, with type-specific properties validated through shape utilities.
Automatic parent detection
The creation system processes shapes through validation, parent assignment, coordinate transformation, and property merging. Shapes receive auto-generated IDs if none are provided, determine their parents based on position and containment rules, and are placed at the correct z-index in the hierarchy. Current editor styles are applied automatically, with type-specific properties validated through shape utilities.
Automatic parent detection
The creation system processes shapes through validation, parent assignment, coordinate transformation, and property merging. Shapes receive auto-generated IDs if none are provided, determine their parents based on position and containment rules, and are placed at the correct z-index in the hierarchy. Current editor styles are applied automatically, with type-specific properties validated through shape utilities.
Lock enforcement and validation
Shape updates use partial objects that merge with existing shape data while respecting lock states and maintaining referential integrity. The system validates each update against shape schemas, removes invalid changes, and processes multiple updates as atomic operations. Animation cleanup ensures manually updated shapes are removed from active animations for consistent behavior.
Lock enforcement and validation
Shape updates use partial objects that merge with existing shape data while respecting lock states and maintaining referential integrity. The system validates each update against shape schemas, removes invalid changes, and processes multiple updates as atomic operations. Animation cleanup ensures manually updated shapes are removed from active animations for consistent behavior.
Lock enforcement and validation
Shape updates use partial objects that merge with existing shape data while respecting lock states and maintaining referential integrity. The system validates each update against shape schemas, removes invalid changes, and processes multiple updates as atomic operations. Animation cleanup ensures manually updated shapes are removed from active animations for consistent behavior.
Lock enforcement and validation
Shape updates use partial objects that merge with existing shape data while respecting lock states and maintaining referential integrity. The system validates each update against shape schemas, removes invalid changes, and processes multiple updates as atomic operations. Animation cleanup ensures manually updated shapes are removed from active animations for consistent behavior.
Automatic transforms
The transform system manages conversions between page space, parent space, and shape-local coordinates using cached transformation matrices. When shapes are reparented, their page coordinates are preserved through automatic space conversion. Efficient matrix caching allows it to handle complex nested hierarchies without requiring manual calculations.
Automatic transforms
The transform system manages conversions between page space, parent space, and shape-local coordinates using cached transformation matrices. When shapes are reparented, their page coordinates are preserved through automatic space conversion. Efficient matrix caching allows it to handle complex nested hierarchies without requiring manual calculations.
Automatic transforms
The transform system manages conversions between page space, parent space, and shape-local coordinates using cached transformation matrices. When shapes are reparented, their page coordinates are preserved through automatic space conversion. Efficient matrix caching allows it to handle complex nested hierarchies without requiring manual calculations.
Automatic transforms
The transform system manages conversions between page space, parent space, and shape-local coordinates using cached transformation matrices. When shapes are reparented, their page coordinates are preserved through automatic space conversion. Efficient matrix caching allows it to handle complex nested hierarchies without requiring manual calculations.
Agent starter kit
Give your AI agents visual superpowers. Allow them to read drawings, generate diagrams, and interact with canvas elements just like human users. You handle the AI integration, tldraw handles the complex canvas interactions, shape recognition, and visual rendering.
Agent starter kit
Give your AI agents visual superpowers. Allow them to read drawings, generate diagrams, and interact with canvas elements just like human users. You handle the AI integration, tldraw handles the complex canvas interactions, shape recognition, and visual rendering.
Agent starter kit
Give your AI agents visual superpowers. Allow them to read drawings, generate diagrams, and interact with canvas elements just like human users. You handle the AI integration, tldraw handles the complex canvas interactions, shape recognition, and visual rendering.
Agent starter kit
Give your AI agents visual superpowers. Allow them to read drawings, generate diagrams, and interact with canvas elements just like human users. You handle the AI integration, tldraw handles the complex canvas interactions, shape recognition, and visual rendering.
Examples
Examples
Examples
Examples
Shape control without the hassle
From creation to transforms, the system keeps everything in order.
Shape control without the hassle
From creation to transforms, the system keeps everything in order.
Shape control without the hassle
From creation to transforms, the system keeps everything in order.
Shape control without the hassle
From creation to transforms, the system keeps everything in order.
© 2025 tldraw