Introduction
Buerli is a powerful client-side development environment for building browser-based CAD applications. It is built on top of the ClassCAD engine and provides a set of tools and components to integrate easily with modern web environments.
Get ClassCAD
Buerli needs a running ClassCAD engine. It runs in the browser as WebAssembly, or natively on a server.
- WebAssembly: nothing to install. Make a public access token on your ClassCAD account; the page passes it to the engine, which fetches its key with it.
- Native: the engine for Windows, Linux or Docker, with its key, under Downloads on your ClassCAD account (Business plan). Its server,
classcad-socketio, needs Node.js 20 or newer.
Get Buerli
First, install the necessary packages. We need Buerli, usually Threejs, and optionally React and React-three-fiber (and their types if you use Typescript).
# Buerli packages
npm install @buerli.io/classcad @buerli.io/react
# Client packages
npm install three @react-three/fiber
Usage
Connect to the engine with init from @buerli.io/classcad:
WASMClientruns the engine in the browser.SocketIOClientconnects to a native engine through the ClassCAD server.
import { init, WASMClient, SocketIOClient } from '@buerli.io/classcad'
// WebAssembly, with a public access token from your ClassCAD account
init((drawingID) => new WASMClient(drawingID, { token: 'ccpk_…' }))
// Or a native engine on your server
// init((drawingID) => new SocketIOClient('ws://localhost:9091', drawingID))
Refer to the Buerli API documentation for more information on how to use the API and the available methods.