Loading project Things
A CAD program that runs in the browser
Loading README and project media…
This project aims to create a new CAD program from scratch. It is small, it runs in a web browser, and the source code is available for free here on Github.
Legacy CAD programs have taken many thousands of years of collective engineering time to get where they are so this program will never be able to compete on breadth of features. But CADmium is intended to capture 80% of the most common CAD use cases while doing less than 10% of the work. For now we are targeting the home hobbyist who just wants to design a widget for their 3D printer, not a company that wants to design a car or airplane, although that will come later.
If you're looking for:
Then this project may be for you!
Status: Early prototype. This tool is not yet an MVP, but is being developed in the open. Please do not share this to HN or Reddit or things like that. ha, well I guess that ship has sailed!
Demos: We are currently racing toward our first demo release, V0.0.1. This is a good first exercise for us to decide on build and release processes.
After that we will do a few more demo (V0.0.*) releases, aggregating features until it feels pretty usable.
Alpha: When it feels like we've reached an MVP that people might actually want to use, it's time to release an Alpha version (V0.1.0) and actively solicit feedback from users. We'll use that feedback to make more improvements, re-inventing things if necessary to achieve a great workflow.
Beyond that, we'll see!
The boundary representation engine under the hood is truck, which is written in rust and is not dependent on any legacy b-rep engine.
Leveraging truck, we wrote a small rust library called cadmium which provides structs for projects, workspaces, sketches, extrusions, and constraints. Our goal is that this rust library provides all the same functionality as the UI for anyone who prefers code-first CAD. This library is able to save and load projects to disk as json. We have also built a set of javascript bindings so that the whole thing can be compiled to wasm and run in a browser.
The UI is built with SvelteKit and Tailwind. It is hosted with Github Pages. We use three.js for rendering, which in this case uses WebGL under the hood. We use Threlte to manage the scene graph declaratively.
This software is offered under the Elastic License 2.0. In summary, you can do whatever you like with this software except offer it as a service to third parties.
If you're just trying to kick the tires, click here to view the live web demo.
To build locally using pnpm workspace & turbo:
git clone https://github.com/Cadmium-Co/CADmium.git
cd CADmium
pnpm install
pnpm dev
We use pnpm to manage the monorepo. Please follow the instructions here to install: https://pnpm.io/installation#using-a-standalone-script
If you're new to node you can use pnpm to manage nodejs:
# https://pnpm.io/cli/env#use
pnpm env use --global 20
First install rust using rustup: https://rustup.rs
Then install wasm-pack
cargo install wasm-pack
turbo test
Playwright is used for e2e testing. You may be prompted with a command to install it.
For manjaro/archlinux folks it may report missing dependencies. On manjaro the missing dependencies are solved thanks to this comment:
yay -S aur/enchant1.6 aur/icu66 aur/libwebp052
Watch vitest unit tests only:
cd applications/web
pnpm test:unit -w
To build and run the Rust tests:
cargo test
We are actively seeking contributors! Please join the Discord and come help out!
Most especially, we need help in the following areas:
Design: The tool must look and feel good and we are not designers. We would love contributions in the form of:
Rust: This is our first project in Rust. We need help from experienced Rustaceans to:
Svelte: This is our first project using Svelte. We'd love an experienced set of eyes to:
If you feel like you would be willing and able to help, please join our discord!
Github project for tracking progress is here