# Bim3dEditor
**Repository Path**: songmy1093697597/bim3d-editor
## Basic Information
- **Project Name**: Bim3dEditor
- **Description**: 基于 webgpu/webgl/three.js 的开源 CAD 转 3D 编辑器。 内置智慧家装、BIM建模、数字孪生,智慧城市、web游戏, WebGPU示例。
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://mengyusong.github.io/bim3d-editor/
- **GVP Project**: No
## Statistics
- **Stars**: 468
- **Forks**: 175
- **Created**: 2022-08-05
- **Last Updated**: 2025-08-23
## Categories & Tags
**Categories**: 3d-engine
**Tags**: Threejs, webgl, WebGPU, React
## README
Bim3d Editor
作者 : songmy - 开源贡献 : 603203658(QQ)
**_Bim3d Editor_** 使用全球流行的渐进式 _JavaScript_ 框架 _Vue.js_ 和优秀的 _webgl/webgpu_ 库 _Three.js_ 打造在线可编辑的 _Cad_ 解析编辑器和自由的 _3D_ 建模功能. 同时内置了 _科技城市_, _数字孪生_ , _智能家装_ , _web游戏_ , _数字工业_, _星地计算_, _WebGPU_ 等相关3D渲染项目的支持案例.
要使用本项目,你可能需要提前了解以下技术:
- [_Monorepo_](https://monorepo.tools/) 包含多个不同项目的单个存储库,具有明确定义的关系。
- [_Pnpm_](https://pnpm.io/) 快速、节省空间的软件包管理器。
- [_Typescript_](https://www.typescriptlang.org/) TypeScript 是一种基于 JavaScript 构建的强类型编程语言,可为您提供任何规模的更好工具。
- [_Three.js_](https://threejs.org) 一个跨浏览器JavaScript库和应用程序编程接口(API),用于使用WebGL在web浏览器中创建和显示动画三维计算机图形。
- [_Vue_](https://cn.vuejs.org/) 渐进式 JavaScript 框架, 易学易用,性能出色,适用场景丰富的 Web 前端框架.
- [_VueRouter_](https://router.vuejs.org/zh/) Vue.js 的官方路由,为 Vue.js 提供富有表现力、可配置的、方便的路由.
- [_Pinia_](https://pinia.vuejs.org/zh/) 符合直觉的Vue.js 状态管理库,类型安全、可扩展性以及模块化设计。
- [_Vite_](https://vitejs.cn/vite3-cn/) 一种新型前端构建工具,能够显著提升前端开发体验。
- [_Tailwindcss_](https://tailwindcss.com/) 一个实用优先的 CSS 框架,其中包含 flex、pt-4、text-center 和 rotate-90 等类,可以直接在标记中组合以构建任何设计。
项目预览地址: https://mengyusong.github.io/bim3d-editor/
**[稳定的版本通道 alphav1.0](https://gitee.com/songmy1093697597/bim3d-editor/releases/tag/v1.0-alpha)**
[](https://gitee.com/songmy1093697597/bim3d-editor/blob/master/LICENSE)
## 安装
### Bim3d Editor
Bim3d 系列项目自_alpha1.0_开始采用Monorepo管理代码仓库,同时使用最近的依赖库,开发一站式可编辑的3D项目,目前可支持学习和扩展.
### 安装依赖
1. `node -v` 检查当前 node 版本号,确认为 node@18+.
2. 确定全局安装了最新的 Pnpm 版本:
```sh
$ npm install --global corepack@latest
```
为了查看 Pnpm 的命令行帮助,你可以输入:
```sh
$ pnpm -h
```
3. 假设你已安装完毕,在全局文件夹下运行:
```sh
$ pnpm install
```
4. 然后去到你感兴趣的项目下运行以下命令启动开发预览:
```sh
$ pnpm install
$ pnpm dev
```
旧版本
- **[v1.x]** ([Bim3dEditor from v0.0 to v1.0])
- **[v0.x]** ([Bim3dEditor to v0.0])
**Note:** `@next` only points to pre-releases.
Use `@latest` for the latest stable release.
访问开源仓库 [`store` guide](https://gitee.com/songmy1093697597/bim3d-editor) 获取更多关于引擎的细节。
## 赞助商
### Diamond 💎
Diamond Sponsors are those who have pledged \$100/month or more to Bim3dEditor.
### Gold 🏆
Gold Sponsors are those who have pledged \$500/month or more to Bim3dEditor.
### More backers
See the full list of [our backers](https://gitee.com/songmy1093697597/bim3d-editor).
## 开始使用 Bim3d-Editor
假设你已经克隆了本仓库,可以从apps开始直接修改使用:
目前仍处于开发版本,更多的细节请star本项目并Fork.也可以打开预览地址:https://mengyusong.github.io/bim3d-editor/ 查看最新的进度。
## 问答
有关不涉及对代码库进行更改的操作问题,请参阅代码。
## 示例
请查看预览项目。
## 文档
- [_Bim3dEditor_](https://gitee.com/songmy1093697597/bim3d-editor/tree/master)
- [three.js](https://threejs.org/)
- [react](https://react.dev/)
- [MUI](https://mui.com/)
- [Rush](https://rushjs.io/zh-cn/)
## 编辑器
请参阅 bim3d-editor 项目
## 贡献
阅读[contributing guide](/README.md)了解我们的开发过程,如何提出错误修复和改进,以及如何构建和测试您的更改。
为Bim3dEditor核心贡献的不仅仅是问题和拉取请求!
还有许多其他方法[支持Bim3dEditor](https://gitee.com/songmy1093697597/bim3d-editor)除了贡献代码库之外。
## 变更记录
[changelog](https://gitee.com/songmy1093697597/bim3d-editor) 定期更新,以反映每个新版本中的变化。
## 开源许可
本项目根据以下条款获得许可:
[MIT license](/LICENSE).
Bim3d Editor
**Bim3d Editor** Use the world's popular progressive JavaScript framework _Vue.js_ and the excellent _webgl/webgpu_ library _Three.js_ to create an online editable CAD parsing editor and free _3D_ modeling capabilities. At the same time, it has built-in support cases for related 3D rendering projects such as _Techno-City_, _Digital Twin_, _Smart Home Improvement_, _web Games_, _Digital Industry_, _Satellite-to-Earth Computing_, _WebGPU_, etc.
To use this project, you may need to know the following techniques in advance:
- [_Monorepo_](https://monorepo.tools/) A single repository with multiple different items, with well-defined relationships.
- [_Pnpm_](https://pnpm.io/) Fast, space-saving package manager.
- [_Typescript_](https://www.typescriptlang.org/) TypeScript is a strongly typed programming language built on JavaScript that gives you better tools at any scale.
- [_Three.js_](https://threejs.org) A cross-browser JavaScript library and application programming interface (API) for creating and displaying animated 3D computer graphics in a web browser using WebGL.
- [_Vue_](https://cn.vuejs.org/) Progressive JavaScript framework, easy to learn and use, excellent performance, and a web front-end framework with rich application scenarios.
- [_VueRouter_](https://router.vuejs.org/zh/) Vue.js's official route, which provides expressive, configurable, and convenient routing for Vue.js.
- [_Pinia_](https://pinia.vuejs.org/zh/) Intuitive Vue.js state management library with type safety, extensibility, and modularity.
- [_Vite_](https://vitejs.cn/vite3-cn/) A new front-end build tool that dramatically improves the front-end development experience.
- [_Tailwindcss_](https://tailwindcss.com/) A utility-first CSS framework with classes like flex, pt-4, text-center, and rotate-90 that can be combined directly in markup to build any design.
Project preview address: https://mengyusong.github.io/bim3d-editor/
**[Stable channel v1](https://gitee.com/songmy1093697597/bim3d-editor)**
[](https://gitee.com/songmy1093697597/bim3d-editor/blob/master/LICENSE)
## Installation
### Bim3d Editor
Since _alpha1.0, the Bim3d family of projects has been using Monorepo to manage the code repository, and using the most recent dependency libraries to develop one-stop editable 3D projects, which can now be used to learn and extend.
### Install dependencies
1. 'node -v' checks the current node version number and confirms that it is node@18+.
2. Make sure the latest PNPM version is installed globally:
```sh
$ npm install --global corepack@latest
```
In order to view the command-line help for Pnpm, you can enter:
```sh
$ pnpm -h
```
3. Assuming you've installed it, run it in the global folder:
```sh
$ pnpm install
```
4. Then go to the project you are interested in and run the following command to start the development preview:
```sh
$ pnpm install
$ pnpm dev
```
Older versions
- **[v1.x]** ([Bim3dEditor from v3 to v4]
- **[v0.x]** ([Bim3dEditor to v1])
**Note:** `@next` only points to pre-releases.
Use `@latest` for the latest stable release.
Visit our [`store` guide](https://gitee.com/songmy1093697597/bim3d-editor) for more information about engine.
## Sponsors
### Diamond 💎
Diamond Sponsors are those who have pledged \$100/month or more to Bim3dEditor.
### Gold 🏆
Gold Sponsors are those who have pledged \$500/month or more to Bim3dEditor.
### More backers
See the full list of [our backers](https://gitee.com/songmy1093697597/bim3d-editor).
## Getting started with Bim3d-Editor
Assuming that you have cloned this repository, you can directly modify it from main.tsx:
```jsx
import ReactDom from "./views/Views";
new ReactDom();
```
It is still in the development version. For more details, please click star and fork. You can also open the preview address: https://mengyusong.github.io/bim3d-editor/ View the latest progress.
## Questions
For how-to questions that don't involve making changes to the code base, please see code.
## Examples
none
## Documentation
- [Bim3dEditor]
- [three.js]
- [react]
- [MUI]
## Premium themes
You can find complete templates and themes in the code.
## Contributing
Read the [contributing guide](/README.md) to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes.
Contributing to Bim3dEditor Core is about more than just issues and pull requests!
There are many other ways to [support Bim3dEditor](https://gitee.com/songmy1093697597/bim3d-editor) beyond contributing to the code base.
## Changelog
The [changelog](https://gitee.com/songmy1093697597/bim3d-editor) is regularly updated to reflect what's changed in each new release.
## License
This project is licensed under the terms of the
[MIT license](/LICENSE).