Overview

Welcome to Truck, a pure-Rust CAD kernel with modern, modular tools for geometric modeling. This book walks through meshes and B-reps with Truck.

The three core ideas

  1. Trendy tools: Rust for safety/performance; Truck’s mesh and B-rep crates for modern CAD workflows.
  2. Traditional arts (modernized): Re-implements classic CAD concepts (B-rep, NURBS) with Rust for stability and testability.
  3. Modular Design (Theseus’ Ship): Small, replaceable crates so you can swap or evolve parts independently without breaking the whole system.

Who this book is for

  • Users: Build apps with Truck and other libraries.
  • Developers: Create new geometric tools/elements on Truck.
  • Contributors: Contribute directly to Truck’s codebase.

This tutorial focuses primarily on Users.

System requirements

  • Rust toolchain (install via rustup.rs)
  • CMake (only for running tests)

Windows

  • Keep Windows 10 up to date.
  • Install Visual Studio C++ Build Tools (update if already installed).
  • Install Rust: rustup.rs (choose MSVC toolchain; rustup update if already installed).
  • Notes: Tested with MSVC. Windows 8 is likely unsupported.

macOS

  • Keep macOS up to date.
  • Install Rust: rustup.rs (or rustup update if installed).
  • Notes: No additional GPU setup required for the chapters covered here.

Linux

  • Not officially supported yet (limited testing).
  • CI builds use Linux containers; official support is still evolving.