Skip to content
Back to search

bitbybit

Monorepo for 3D algorithms of Bitbybit platform, which helps programming geometry on the browser. Use with ThreeJS, BabylonJS or PlayCanvas. Build your own core integration or execute algorithms in NodeJS.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bitbybit-dev/bitbybit with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bitbybit-dev/bitbybit'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bitbybit-dev--bitbybit/badge.svg)](/listings/bitbybit-dev--bitbybit)

HTML

<a href="/listings/bitbybit-dev--bitbybit"><img src="/api/listings/bitbybit-dev--bitbybit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Scaffold a fully-configured 3D CAD project in seconds:

npx @bitbybit-dev/create-app my-project

The CLI first asks you to pick an **app type**:

- **Frontend** - Browser-based 3D/CAD app. Choose a game engine (Three.js, Babylon.js, or PlayCanvas) and OCCT architecture (32-bit, 64-bit, or 64-bit MT). You get a Vite + TypeScript project with all three CAD kernels (OCCT, JSCAD, Manifold) pre-configured. - **CAD Cloud** - Full-stack project with server-side CAD via our [CAD Cloud API](https://learn.bitbybit.dev/api/cloud-api). Choose a backend template (Hono + SDK, Hono + REST, Node.js + SDK, Node.js + REST, or .NET + REST). You get a React + Three.js frontend that proxies requests through your backend - your API key never leaves the server.

cd my-project
npm install
npm run dev

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 240 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Bitbybit Monorepo
  2. 3D CAD algorithms for the web. This monorepo contains all Bitbybit NPM packages plus example applications, all MIT licensed. Their TypeScript is open source; the Bitbybit OCCT Kernel the `@bitbybit-dev/occt` package ships is MIT-licensed WebAssembly whose C++ kernel layer is closed source.
  3. Written to be used by people and by AI coding agents alike: every function is published in a form an agent can look up while it writes - see [Build It With an AI Agent](#build-it-with-an-ai-agent).
  4. ## License
  5. Source code in `packages/`, `languages/`, and `examples/` is [MIT licensed](./LICENSE). The Bitbybit OCCT Kernel the `occt` package ships is MIT-licensed too ([LICENSE](./packages/dev/occt/LICENSE)), but it is not built from this repository: its C++ kernel layer is closed source, and OCCT and the other open-source components compiled into it keep their own licenses ([NOTICE](./packages/dev/occt/NOTICE)). The guides in `guides/` are [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); the documentation at [learn.bitbybit.dev](https://learn.bitbybit.dev) is published separately, under its own terms. Logos, trademarks, and media assets are **not** open-source - see [CONTENT-LICENSE.md](./CONTENT-LICENSE.md) for details.
  6. # [FULL PLATFORM AT BITBYBIT.DEV](https://bitbybit.dev)
  7. # [LEARN BITBYBIT](https://learn.bitbybit.dev)
  8. # [TYPESCRIPT API REFERENCE](https://docs.bitbybit.dev)
  9. <img src="https://bitbybit.dev/files/site/git-cover.png" alt="Picture showing bitbybit.dev platform">
  10. ## Quick Start
  11. Scaffold a fully-configured 3D CAD project in seconds:
  12. ```bash
  13. npx @bitbybit-dev/create-app my-project
  14. ```
  15. The CLI first asks you to pick an **app type**:
  16. - **Frontend** - Browser-based 3D/CAD app. Choose a game engine (Three.js, Babylon.js, or PlayCanvas) and OCCT architecture (32-bit, 64-bit, or 64-bit MT). You get a Vite + TypeScript project with all three CAD kernels (OCCT, JSCAD, Manifold) pre-configured.
  17. - **CAD Cloud** - Full-stack project with server-side CAD via our [CAD Cloud API](https://learn.bitbybit.dev/api/cloud-api). Choose a backend template (Hono + SDK, Hono + REST, Node.js + SDK, Node.js + REST, or .NET + REST). You get a React + Three.js frontend that proxies requests through your backend - your API key never leaves the server.
  18. ```bash
  19. cd my-project
  20. npm install
  21. npm run dev
  22. ```
  23. ## Build It With an AI Agent
  24. Bitbybit has 2240 functions across three CAD kernels - more than any model remembers, so an agent working from memory invents plausible names that do not exist. Give it the **[Bitbybit CAD MCP](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/bitbybit-mcp)** instead and it looks up the exact signature, defaults, return type and examples for the version you have installed. It is free and needs no account:
  25. ```bash
  26. claude mcp add --transport http bitbybit https://mcp.bitbybit.dev/mcp
  27. ```
  28. Codex, Cursor, VS Code, Gemini CLI, Windsurf, Zed, the JetBrains IDEs, claude.ai, ChatGPT and the Claude API connect to the same endpoint, and [`npx -y @bitbybit-dev/mcp`](https://www.npmjs.com/package/@bitbybit-dev/mcp) runs it locally against the `@bitbybit-dev` packages in your project - [every configuration is here](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/bitbybit-mcp).
  29. [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/link/mcp/install?name=bitbybit&config=eyJ1cmwiOiJodHRwczovL21jcC5iaXRieWJpdC5kZXYvbWNwIn0=) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=bitbybit&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.bitbybit.dev%2Fmcp%22%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=bitbybit&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.bitbybit.dev%2Fmcp%22%7D&quality=insiders)
  30. | | What it gives an agent | Cost |
  31. |---|---|---|
  32. | **[Bitbybit CAD MCP](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/bitbybit-mcp)** | The exact API of the version you use: search, full signatures with defaults, examples, and the guide on where geometry should run. Read-only. | Free, no account |
  33. | **[Bitbybit CAD Cloud MCP](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/cad-cloud-mcp)** | Hands as well as knowledge: the agent runs operations and pipelines on CAD Cloud, converts STEP to glTF, runs Pro algorithms, and returns the files. | A [CAD Cloud](https://bitbybit.dev/cad-cloud) key |
  34. | **[Context files](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/prompt-contexts)** and **[Context7](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/context-7)** | The whole API as one file to attach, for assistants that cannot speak MCP. | Free |
  35. Every answer carries a tier - `oss` runs in these MIT packages anywhere, `platform-pro` inside the bitbybit.dev editors, `cloud-pro` only on CAD Cloud - so an agent never sends you to a paid service for something the free packages already do. The [AI section of the documentation](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/intro) covers all of it.
  36. ## Support the Mission
  37. ⭐ **[Subscribe - Silver or Gold plan](https://bitbybit.dev/auth/pick-plan)** | **[Get API Key for CAD Cloud](https://bitbybit.dev/auth/pick-plan?api-keys=true)**
  38. Check out [3D Bits app for Shopify](https://apps.shopify.com/3d-bits-1) - interactive 3D product configurators for e-commerce.
  39. Your subscription directly funds continued development of these packages.
  40. ## Important Topics
  41. | Topic | Link |
  42. |-------|------|
  43. | Getting Started | https://learn.bitbybit.dev/learn/getting-started/overview |
  44. | TypeScript API Reference | https://docs.bitbybit.dev |
  45. | API Reference - OCCT (`bitbybit.occt`) | https://docs.bitbybit.dev/classes/Bit.OCCT |
  46. | API Reference - JSCAD kernel | https://docs.bitbybit.dev/classes/Bit.JSCAD |
  47. | API Reference - Manifold kernel | https://docs.bitbybit.dev/classes/Bit.Manifold |
  48. | NPM Packages Intro | https://learn.bitbybit.dev/learn/npm-packages/intro |
  49. | Integrate with Three.js | https://learn.bitbybit.dev/learn/npm-packages/threejs/start-with-three-js |
  50. | Integrate with BabylonJS | https://learn.bitbybit.dev/learn/npm-packages/babylonjs/start-with-babylon-js |
  51. | Integrate with PlayCanvas | https://learn.bitbybit.dev/learn/npm-packages/playcanvas/start-with-playcanvas |
  52. | CAD Cloud API | https://learn.bitbybit.dev/api/cloud-api |
  53. | Script Runners | https://learn.bitbybit.dev/learn/runners/intro |
  54. | 3D Bits for Shopify | https://learn.bitbybit.dev/learn/3d-bits/intro |
  55. | AI Coding Agents - Overview | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/intro |
  56. | Bitbybit CAD MCP - free, version-exact API lookups | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/bitbybit-mcp |
  57. | Bitbybit CAD Cloud MCP - let an agent run the geometry | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/cad-cloud-mcp |
  58. | Context Files for Assistants Without MCP | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/prompt-contexts |
  59. | Unit Testing Approach | https://learn.bitbybit.dev/learn/github/unit-tests |
  60. | Live Unit Test Coverage | https://github.com/bitbybit-dev/bitbybit/actions/workflows/verify.yml |
  61. | Blog | https://learn.bitbybit.dev/blog |
  62. ## How Bitbybit Fits Into Your Stack
  63. <img src="https://learn.bitbybit.dev/img/bitbybit-dev-cad-platform.webp" alt="Diagram of the Bitbybit platform showing how a website reaches its geometry: script runners, iframe embeds, the NPM packages, the CAD Cloud REST API and AI agents over MCP">
  64. The diagram shows every way a website can reach Bitbybit geometry, and where the NPM packages below sit among them:
  65. - **NPM packages** - this repository. The kernels compile to WebAssembly and run in your users' browsers or in your own Node process, inside your build, all MIT licensed.
  66. - **[Script runners](https://learn.bitbybit.dev/learn/runners/intro)** - one script file loads the same engine and executes scripts exported from the visual editors, with no build step.
  67. - **Iframe embeds** - a project published on [bitbybit.dev](https://bitbybit.dev) dropped straight into a page.
  68. - **[CAD Cloud REST API](https://learn.bitbybit.dev/api/cloud-api)** - your backend sends the work to our managed kernels and gets results back as files, for the Pro algorithms and for compute you would rather not host.
  69. - **[AI agents](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/intro)** - the MCP servers above, writing code against any of these paths or running the geometry themselves.
  70. The [full walkthrough of the diagram](https://learn.bitbybit.dev/learn/intro) is on learn.bitbybit.dev.
  71. ## NPM Packages
  72. | Package | Description |
  73. |---------|-------------|
  74. | [@bitbybit-dev/babylonjs](https://www.npmjs.com/package/@bitbybit-dev/babylonjs) | BabylonJS engine integration for drawing CAD geometry |
  75. | [@bitbybit-dev/threejs](https://www.npmjs.com/package/@bitbybit-dev/threejs) | Three.js engine integration for drawing CAD geometry |
  76. | [@bitbybit-dev/playcanvas](https://www.npmjs.com/package/@bitbybit-dev/playcanvas) | PlayCanvas engine integration for drawing CAD geometry |
  77. | [@bitbybit-dev/core](https://www.npmjs.com/package/@bitbybit-dev/core) | Core assembly layer combining all CAD kernels |
  78. | [@bitbybit-dev/occt](https://www.npmjs.com/package/@bitbybit-dev/occt) | OpenCascade CAD kernel (works in Node.js & browser) |
  79. | [@bitbybit-dev/occt-worker](https://www.npmjs.com/package/@bitbybit-dev/occt-worker) | OCCT via WebWorker (non-blocking, browser only) |
  80. | [@bitbybit-dev/manifold](https://www.npmjs.com/package/@bitbybit-dev/manifold) | Manifold fast mesh booleans (works in Node.js & browser) |
  81. | [@bitbybit-dev/manifold-worker](https://www.npmjs.com/package/@bitbybit-dev/manifold-worker) | Manifold via WebWorker (non-blocking, browser only) |
  82. | [@bitbybit-dev/jscad](https://www.npmjs.com/package/@bitbybit-dev/jscad) | JSCAD solid modeling (works in Node.js & browser) |
  83. | [@bitbybit-dev/jscad-worker](https://www.npmjs.com/package/@bitbybit-dev/jscad-worker) | JSCAD via WebWorker (non-blocking, browser only) |
  84. | [@bitbybit-dev/ifc](https://www.npmjs.com/package/@bitbybit-dev/ifc) | IFC building models read, written and authored in TypeScript (works in Node.js & browser) |
  85. | [@bitbybit-dev/ifc-worker](https://www.npmjs.com/package/@bitbybit-dev/ifc-worker) | IFC via WebWorker (non-blocking, browser only) |
  86. | [@bitbybit-dev/base](https://www.npmjs.com/package/@bitbybit-dev/base) | Base math/vector/matrix algorithms used by all packages |
  87. | [@bitbybit-dev/create-app](https://www.npmjs.com/package/@bitbybit-dev/create-app) | CLI tool to scaffold 3D/CAD projects |
  88. | [@bitbybit-dev/cad-cloud-sdk](https://www.npmjs.com/package/@bitbybit-dev/cad-cloud-sdk) | TypeScript SDK for the CAD Cloud API |
  89. | [@bitbybit-dev/mcp](https://www.npmjs.com/package/@bitbybit-dev/mcp) | MCP server that documents this API for AI coding agents |
  90. ## NPM Package Architecture
  91. <img src="https://bitbybit.dev/files/site/npm-package-architecture.jpeg" alt="Schematic diagram showing the architecture of all NPM packages">
  92. ## Example Applications
  93. All examples live in the [`examples/`](https://github.com/bitbybit-dev/bitbybit/tree/master/examples) directory of this monorepo:
  94. | App | Engine | Source Code |
  95. |-----|--------|-------------|
  96. | [Hex Shell](https://learn.bitbybit.dev/learn/npm-packages/threejs/advanced-parametric-3d-model) | Three.js | [GitHub](https://github.com/bitbybit-dev/bitbybit/tree/master/examples/vite/threejs/hex-shell) |
  97. | [Cup Configurator](https://app-store.bitbybit.dev/cup) | Three.js | [GitHub](https://github.com/bitbybit-dev/bitbybit/tree/master/examples/vite/threejs/cup) |
  98. | [Hex House Concept](https://learn.bitbybit.dev/learn/npm-packages/threejs/hex-house-concept) | Three.js | [GitHub](https://github.com/bitbybit-dev/bitbybit/tree/master/examples/vite/threejs/hex-house-concept) |
  99. | Starter Template | BabylonJS | [GitHub](https://github.com/bitbybit-dev/bitbybit/tree/master/examples/vite/babylonjs/starter-template) |
  100. | Starter Template | Three.js | [GitHub](https://github.com/bitbybit-dev/bitbybit/tree/master/examples/vite/threejs/starter-template) |
  101. | Starter Template | PlayCanvas | [GitHub](https://github.com/bitbybit-dev/bitbybit/tree/master/examples/vite/playcanvas/starter-template) |
  102. | [Terrace Furniture](https://app-store.bitbybit.dev/terrace-furniture) | BabylonJS | Closed source |
  103. ## Bitbybit Platform
  104. Beyond these free NPM packages, the Bitbybit platform includes:
  105. - **[Visual Programming Editors](https://bitbybit.dev)** - Rete & Blockly drag-and-drop 3D modeling, plus a Monaco TypeScript editor with full IntelliSense
  106. - **[CAD Cloud API](https://learn.bitbybit.dev/api/cloud-api)** - Build full [pipelines](https://learn.bitbybit.dev/api/sdk/typescript/pipelines) that compose all Bitbybit algorithms, where each step can reference outputs of previous steps. Supports parametric model generation, STEP-to-glTF conversion, and complex CAD workflows via HTTP. [TypeScript SDK available](https://www.npmjs.com/package/@bitbybit-dev/cad-cloud-sdk).
  107. - **[Bitbybit Studio](https://studio.bitbybit.dev)** - A growing visual dashboard where API Key users can generate models, convert files, build [pipelines with a GUI](https://learn.bitbybit.dev/api/studio/intro), inspect tasks, and preview 3D results
  108. - **[3D Bits for Shopify](https://apps.shopify.com/3d-bits-1)** - Interactive 3D product configurators for your Shopify store. [Documentation](https://learn.bitbybit.dev/learn/3d-bits/intro).
  109. - **[Script Runners](https://learn.bitbybit.dev/learn/runners/intro)** - Execute Rete/Blockly/TypeScript scripts directly on your website without writing code
  110. - **[Built for AI Coding Agents](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/intro)** - The free [Bitbybit CAD MCP](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/bitbybit-mcp) gives Claude Code, Codex, Cursor, VS Code, claude.ai and ChatGPT the exact API of the version you use; the [Bitbybit CAD Cloud MCP](https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/cad-cloud-mcp) lets an agent run geometry on CAD Cloud with a key. Context files cover assistants without MCP.
  111. - **[Business & Enterprise](https://bitbybit.dev/b2b)** - We help businesses and enterprises develop custom applications and spin up optimized CAD tenant workflows on our managed servers
  112. ## Community
  113. - [Discord](https://discord.gg/GSe3VMe)
  114. - [YouTube](https://www.youtube.com/@bitbybitdev?sub_confirmation=1)
  115. - [LinkedIn](https://www.linkedin.com/company/bitbybit-dev)
  116. - [X (Twitter)](https://x.com/bitbybit_dev)
  117. - [Instagram](https://www.instagram.com/bitbybit.dev)
  118. - [Facebook](https://www.facebook.com/bitbybitdev)
  119. - [Blog](https://learn.bitbybit.dev/blog)
  120. ## Watch the Introduction
  121. Matas walks through the platform and the ideas behind it:
  122. [![Introduction by Matas Ubarevicius](https://img.youtube.com/vi/noc6Rg6tMe0/maxresdefault.jpg)](https://www.youtube.com/watch?v=noc6Rg6tMe0)
  123. # Development Setup
  124. ## Contributions
  125. If you're interested in contributing please check our [Contribution guidelines](https://github.com/bitbybit-dev/bitbybit/blob/master/CONTRIBUTING.md) & [code of conduct](https://github.com/bitbybit-dev/bitbybit/blob/master/CODE_OF_CONDUCT.md)
  126. ## First Time Setup and Testing
  127. For first-time developers working on this project, follow these steps to set up the development environment and run all unit tests:
  128. ### Prerequisites
  129. - Node.js 22 or newer (`.tool-versions` pins 22; the nightly workflow also runs 24)
  130. - pnpm 11 (see step 2 below)
  131. - Git
  132. ### Quick Start
  133. 1. Clone the repository:
  134. ```bash
  135. git clone https://github.com/bitbybit-dev/bitbybit.git
  136. cd bitbybit
  137. ```
  138. 2. Install pnpm 11 once (the packages are one pnpm workspace; the `packageManager` field pins the exact version):
  139. ```bash
  140. npm install -g pnpm@11
  141. ```
  142. 3. Run the complete first-time setup (this will install all dependencies, build all packages, and run all unit tests):
  143. ```bash
  144. npm run first-time-setup
  145. ```
  146. ### Available Commands
  147. - `npm run first-time-setup` - Complete setup for new developers (installs dependencies, builds packages, runs tests)
  148. - `npm run setup` - Install dependencies and build all packages without running tests
  149. - `npm run setup-and-test` - Install dependencies, build packages, and run all unit tests
  150. - `npm run test` - Run all unit tests (requires packages to be built first)
  151. - `npm run test:report` - One report over every suite's last results (files, tests, failures, skipped, coverage); written to the job summary on GitHub Actions
  152. - `npm run ci-packages` - Install dependencies for all packages (one `pnpm install --frozen-lockfile` for the workspace)
  153. - `npm run refresh-lockfile` - Rewrite `pnpm-lock.yaml` after a dependency change, without touching node_modules
  154. - `npm run build-packages` - Build and stage all packages (`tsc -b` over generated project references, run by pnpm in dependency order)
  155. - `npm run rebuild-all-packages` - Empty every dist, then build all packages
  156. - `npm run gen:references` - Regenerate the TypeScript project references from the package manifests after a dependency change
  157. - `npm run check:references` - Fail if the project references and the manifests disagree (the first step of `npm test`)
  158. - `npm run lint` - ESLint over the repository, green by the committed suppression baseline; a new finding fails
  159. - `npm run typecheck:strict` - Every package's typecheck under the full strict set
  160. - `npm run check:strict-baselines` - Fail if any package has grown a strict baseline; every package is fully strict, so the check holds the line at zero
  161. - `npm run api:check` - Fail if any package's public API surface differs from the committed report in its `etc/` folder
  162. - `npm run api:update` - Regenerate those API reports after a deliberate change to the public surface
  163. - `npm run check:tarballs` - Pack every built package and install the tarballs together into an empty project, as a user would
  164. ### Running Individual Package Tests
  165. You can also run tests for individual packages:
  166. - `npm run test-base` - Test base package
  167. - `npm run test-occt` - Test OCCT package
  168. - `npm run test-core` - Test core package
  169. - `npm run test-jscad` - Test JSCAD package
  170. - `npm run test-manifold` - Test Manifold package
  171. - `npm run test-threejs` - Test ThreeJS package
  172. - `npm run test-playcanvas` - Test PlayCanvas package
  173. - `npm run test-babylonjs` - Test BabylonJS package
  174. ### Troubleshooting
  175. If you encounter issues during setup:
  176. 1. Make sure you have Node.js 22+ installed (`node --version`)
  177. 2. Clear the pnpm store: `pnpm store prune`
  178. 3. Delete `node_modules` at the root and under `packages/dev/*`, then run `pnpm install`
  179. ## Major Dependencies
  180. BabylonJS, ThreeJS, PlayCanvas, OpenCascade, Manifold, JSCAD, and Verbnurbs - the last of these
  181. deprecated, no longer maintained upstream, and removed in the next major version.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.