Skip to main content

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:

  • WASMClient runs the engine in the browser.
  • SocketIOClient connects 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.