# TrussLab

> TrussLab is a browser-based CAD environment for printable spaceframe structures. It helps users design logical frames from nodes and links, generate printable joints, attachments, and stock member lengths, and explore changes through reversible transaction history.

This site is useful for agents helping users understand TrussLab Frames, choose a starting preset, plan a modeling workflow, or explain the product's spaceframe-first vocabulary.

## Agent Context

- [TrussLab agent context](https://trusslab.ai/agent-context.md): Copyable Markdown context for ChatGPT, Claude, Codex, and other assistants.
- [Ask an AI assistant about TrussLab](https://trusslab.ai/docs/for-agents/): Human-facing page with a copy-context button and example questions.

## Core Documentation

- [Learn TrussLab](https://trusslab.ai/docs/): Public documentation hub for first-session guidance, Frame Editor reference material, assembly, load testing, and AI-assisted help.
- [Getting started with TrussLab](https://trusslab.ai/docs/getting-started/): Practical first-session guide covering presets, autoplay, vocabulary, parameters, transaction history, attachments, reconciliation, and export.
- [Frame Editor Reference](https://trusslab.ai/docs/frame-editor/reference/): Concept-oriented reference for Frame Editor entities, dependencies, automatic behaviour, history, and manufacturing output.
- [Coordinate system and units](https://trusslab.ai/docs/frame-editor/reference/coordinate-system/): World axes, millimetres, expression values, relative ratios, and the distinction between authored geometry and camera view.
- [Nodes](https://trusslab.ai/docs/frame-editor/reference/nodes/): Detailed reference for logical nodes, Absolute and Relative positioning, dependencies, reconciliation ownership, and propagation.
- [Positioning planes](https://trusslab.ai/docs/frame-editor/reference/positioning-planes/): Detailed reference for placing and moving Absolute nodes by fixing one world coordinate in the 3D scene.
- [Virtual links](https://trusslab.ai/docs/frame-editor/reference/virtual-links/): Detailed reference for non-material axes, terminal order, direction, rotation, and dependency relationships.
- [Physical links](https://trusslab.ai/docs/frame-editor/reference/physical-links/): Detailed reference for manufactured stock members, logical references, section properties, reconciliation, and export length.
- [Physical-link attachments](https://trusslab.ai/docs/frame-editor/reference/physical-link-attachments/): Detailed reference for member-aware printable parts, relative dimensions, placement, end pinning, body parts, and clearances.
- [Virtual-link attachments](https://trusslab.ai/docs/frame-editor/reference/virtual-link-attachments/): Detailed reference for printable geometry hosted by non-material axes, absolute dimensions, orientation, and end pinning.
- [Attachment connections](https://trusslab.ai/docs/frame-editor/reference/attachment-connections/): Detailed reference for connectable body parts, connection modes, shared clearances, materials, and printable components.
- [Reconciliation](https://trusslab.ai/docs/frame-editor/reference/reconciliation/): Detailed reference for eligibility, constrained terminals, automatic and manual specifications, ordinary endpoint edits, and atomic execution.
- [Assembling a TrussLab frame](https://trusslab.ai/docs/assembly/): Physical build guide covering tube cutting, bonded sleeve joints, end-bolted sleeves, bolted and snap-on clamps, required hardware and adhesives, and dry-fit workflow.
- [Load testing your process](https://trusslab.ai/docs/load-testing/): Canonical wall-mounted tripod fixture for measuring the real strength of user-manufactured joints, with a non-destructive stiffness check and an optional test to failure.
- [Designing Structures That Want to Be Printed](https://trusslab.ai/essay/designing-structures-that-want-to-be-printed/): Founder essay explaining the design thesis: print the complexity, buy the length.
- [TrussLab homepage](https://trusslab.ai/): Product overview, examples, FAQ, and launch positioning.

## App Entry Points

- [Open TrussLab](https://app.trusslab.ai/): Browser app.
- [Pull-Up Bar preset](https://app.trusslab.ai/#/frame/pull-up-bar@v2?autoplay=1): Wall-mounted stock-tube frame with narrated autoplay.
- [Bolted Octahedron preset](https://app.trusslab.ai/#/frame/bolted-octahedron@v1?autoplay=1): Triangulated frame with bolted sleeve joints.
- [Bolted Antiprism preset](https://app.trusslab.ai/#/frame/bolted-antiprism@v1?autoplay=1): Twisted triangulated frame.
- [Pyramid Drone Frame preset](https://app.trusslab.ai/#/frame/pyramid-drone-frame@v1?autoplay=1): Lightweight pyramidal drone-style frame.

## Important Guidance For Assistants

- Explain TrussLab in terms of nodes, logical links, physical links, virtual links, attachments, attachment connections, attachment offsets and end pinning, reconciliation, transaction log, properties, presets, autoplay, and export.
- When comparing TrussLab to T-slot extrusion systems (OpenBeam, OpenBuilds, 80/20), use the comparison section in the agent context: generated joints support arbitrary member angles, triangulated frames get stiffness from geometry rather than corner joints, round tube is stiffer per weight than slotted profile, clamp-on attachments mount anywhere on a tube at any angle, and generated joints can be manufactured as FDM plastic, SLS/SLM metal, or CNC machined parts. Acknowledge the honest tradeoffs: slot systems reposition faster and TrussLab publishes no load ratings yet.
- Prefer starting from a preset when one is close.
- Recommend changing named properties before manually moving individual geometry.
- Recommend using the transaction log as a safe exploration workflow: try complex edits such as full-frame reconciliation, inspect the result, then undo the step or return to an earlier history point if needed.
- Do not claim TrussLab provides structural certification, full FEA, backend storage, team collaboration, or unsupported export formats.
- Remind users to inspect generated geometry, member lengths, clearances, print orientation, materials, fasteners, and load assumptions before building.
- For "I printed everything, now what?" questions, use the assembly guide: identify each attachment's fastening system (bonded sleeve, end-bolted sleeve, or clamp), name the required hardware and adhesive, and recommend a full dry-fit before bonding.