Cadova is a Swift library for creating 3D models through code, with a focus on 3D printing. It offers a programmable alternative to traditional CAD tools, combining precise geometry with the expressiveness and elegance of Swift.

Cadova models are written entirely in Swift, making them easy to version, reuse, and extend. The result is a flexible and maintainable approach to modeling, especially for those already comfortable with code.

Cadova runs on macOS, Windows, and Linux. To get started, read the Getting Started guide.

Full documentation, including What is Cadova?, is available at cadova.org/docs. See the wiki for related projects: the viewer app, libraries, and example models built with Cadova.

!Platforms

Example

await Model("Hex key holder") {
    // Hex holes for a set of keys, spaced by their own widths
    Stack(.x, spacing: 6, alignment: .centerY) {
        for size in [1.5, 2.0, 2.5, 3.0, 4.0, 5.0, 6.0] {
            RegularPolygon(sideCount: 6, widthAcrossFlats: size + 0.2)
        }
    }
    .offset(amount: 6, style: .round) { holes, outline in
        outline.convexHull()
            .extruded(height: 16, topEdge: .fillet(radius: 2))
            .subtracting {
                holes.extruded(height: 13)
                    .translated(z: 3)
            }
            .withMaterial(.glossyPlastic(.royalBlue))
    }
}

To preview your models, use Cadova Viewer, a native macOS app, or Cadova for VS Code, which works on every platform VS Code runs on. Both reload automatically as your model regenerates.

Cadova uses Manifold-Swift, Apus, Pelagos, Nodal and ThreeMF.

Versioning and Stability

Cadova follows semantic versioning. From 1.0 on, the public API stays source compatible within a major version, so from: "1.0.0" is the recommended dependency requirement. Breaking changes only arrive in a new major version, and anything due to be removed is deprecated first.

Contributions

License

Manifest template

// swift-tools-version: 6.3
import PackageDescription
let package = Package(
    name: "<#name#>",
    platforms: [.macOS(.v15)],
    dependencies: [
        .package(url: "https://github.com/tomasf/Cadova.git", from: "1.0.0"),
    ],
    targets: [
        .executableTarget(
            name: "<#name#>",
            dependencies: ["Cadova"],
            swiftSettings: [.interoperabilityMode(.Cxx)]
        ),
    ]
)