English | 简体中文
TvT.js brings ThreeJS, Vue 3, and TresJS together for digital twins, industrial visualization, online 3D editors, and plugin-based project delivery. It is permanently open-source and free for commercial use.
If this project helps you, please click the "Star⭐" button in the upper-right corner. Your support is what keeps this project moving forward. Thank you!
Since mid-October 2025, the project has fully upgraded its core dependencies, including Vue 3, Tres V5, Fes V4, Cientos V4, and Three.js (r17x → r18x).
If you are upgrading from
tvt.jsV4, please refer to the migration guide: icegl.cn/ask/article/22769
Legacy V4 branch: tres-v4_fes-v3
|
|
For full localization and compatibility details, see the documentation: Details
- Support for domestic hardware platforms
- Support for domestic operating systems and browsers
- Domestic-friendly development and deployment environments
- You can confidently use tvt.js as the frontend foundation for localized 3D visualization projects and digital twin platforms.
- Built on a fully open-source dependency stack, with independent software intellectual property and software copyright registration, open-source and free for commercial use.
Built by icegl. Permanently open-source, free for commercial use, and continuously updated. Please click the Star button in the upper-right corner to follow the project.
This project sits at the intersection of three major ecosystems:
| Ecosystem | Description |
|---|---|
🎲 ThreeJS |
A widely used JavaScript 3D library for browser rendering. |
🍀 Vue3.x |
A modern frontend framework that is approachable, high-performance, and flexible across many Web use cases. |
⚡ TresJS |
A declarative Vue 3 way to build Three.js-powered 3D applications on the frontend. |
✨ Dynamic Component Publishing & Loading Service: 🌏 dcser.icegl.cn
A dynamic component publishing and loading service built around the tvt.js ecosystem, designed for more flexible modular application delivery.
🏕 Preview: 🌏 opensource.icegl.cn
- If needed, you can also use the GitHub Pages mirror: 🌏 https://hawk86104.github.io
- Full-case WeChat Mini Program ecosystem: 🌏 Open in WeChat
- Scan the QR code to browse the full Mini Program demo set:
|
Online 3D Scene Editor Free source export + secondary development 
|
Smart Server Room Project-ready output from the editor 
|
|
Tech Stack Topology Project-ready output from the editor 
|
Hunyuan World Project-ready output from the editor 
|
|
Refining Smart Factory Visualization Project-ready output from the editor 
|
Smart Office Space Project-ready output from the editor 
|
|
UAV Fleet Visualization Project-ready output from the editor 
|
Low-Poly Refinery Free case 
|
|
Low-Poly Server Room Project-ready output from the editor 
|
Plastic Products Factory 3D Project-ready output from the editor 
|
|
Smart Warehouse Management Project-ready output from the editor 
|
Ocean Shipping Visualization Free case 
|
|
Financial Report Analysis 3D Chart Project-ready output from the editor 
|
Paramecium Animation Editor Online animation editor 
|
|
Map Space Editor A GIS editor for projected-map scenes 
|
Multi-Set Oblique Photography 3D Project-ready output from the editor 
|
Tech stack topology example with full project source: Source file
You can reopen this scene in the online editor and export the source again for secondary development: Open in zone3Deditor
Because the project is updated and rebuilt frequently, please clear your browser cache if you encounter access or asset-loading issues.
More demos are available on the preview site.
Node.js >= 20.18 is recommended.
| Step | Command / Action | Description |
|---|---|---|
| 1 | git clone this repository, or download it directly |
Get the project source code |
| 2 | cd into the project root |
Enter the project directory |
| 3 | yarn |
Install dependencies |
| 4 | yarn pre.dev |
Debug the preview workspace |
| 5 | yarn dev |
Debug your own project workspace |
| 6 | yarn pre.build |
Build the preview workspace |
| 7 | yarn build |
Build your own project workspace |
| 8 | yarn pre.dev.one |
Preview only one specific example or plugin |
| 9 | yarn pre.build.one |
Build one specific example or plugin, keeping only configured dependency plugin assets and removing the rest |
| 10 | yarn both |
Run dev and pre.dev at the same time so you can develop your project while comparing against examples and plugins |
User Guide: 🌏 docs.icegl.cn
🧩 Rich Plugin Marketplace: 🌏 tvtstore
🌏 www.icegl.cn/tvtstore includes a wide variety of project scenarios and features. Plugins are an important part of the ICE community ecosystem, and in the marketplace both complete applications and smaller modules are collectively referred to as plugins.
| Plugin Marketplace | Become an Author and Join Us |
|
|
If you run into any issues while using the project, feel free to reach out through the channels below.
Q&A Community: ICE Graphics Community icegl.cn
Community Contributors and Experts: Ask the experts
You are also welcome to join our WeChat and QQ groups. Some groups may already be full, but we are always happy to connect and discuss WebGL together.
| WeChat Mini Program Ecosystem | WeChat Group | QQ Group: 795714357 | Official Account: ICE Graphics Community |
|
|
|
|
|
This project is open-sourced under the Apache License 2.0, is free to use permanently, and supports commercial use.
If you use this project commercially, please comply with the Apache License 2.0 and retain the author attribution and technical support statement.
-
Secondary Development and Copyright Notice
When building on top of this project, including but not limited to feature extensions, UI modifications, or custom adaptations, you must not remove, alter, or hide the copyright notice, author statement, or project source attribution in the header of TvT.js source files, whether your use is commercial or non-commercial.
-
Allowed Commercial Use and Restrictions
You may use this project as the foundation for commercial solutions that are primarily based on your own independently developed core features or products, including paid services and software products.
You may not simply re-open-source this project with only minor changes and charge for it, or package an almost unmodified version as a paid product for sale.
-
Third-Party Components
Copyright and license information for third-party source code and binary files included in this project are marked separately. Please comply with their respective open-source licenses.
Copyright © 2022-2026 by 🧊icegl (https://www.icegl.cn)
All rights reserved.