An open-source framework for building and shipping Web-based 3D visualization projects faster with Vue 3, Three.js, and TresJS.

English | 简体中文

🎉🎉🎊 An Open-Source Framework for Rapid 3D Visualization Delivery 🎊🎉🎉

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.js V4, please refer to the migration guide: icegl.cn/ask/article/22769

Legacy V4 branch: tres-v4_fes-v3

🇨🇳 Web 3D Visualization Framework for Domestic / Xinchuang Environments 🚩

For full localization and compatibility details, see the documentation: Details

1️⃣ Support for domestic hardware platforms
2️⃣ Support for domestic operating systems and browsers
3️⃣ 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.

Ecosystem @ThreeJS @Vue3.x @TresJS

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:

• 🎲 ThreeJS · Learn more A widely used JavaScript 3D library for browser rendering.

• 🍀 Vue3.x · Learn more A modern frontend framework that is approachable, high-performance, and flexible across many Web use cases.

• ⚡ TresJS · Learn more 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]
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]
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.

If you like the project, please support it with a quick three-step combo: Follow 💛 Like ⭐ Fork 👣

✅ Quick Start

1. git clone this repository, or download it directly

2. cd into the project root

3. yarn // install dependencies [Node.js >= 20.18]

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; keep only configured dependency plugin assets and remove 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

📖 Documentation

User Guide: 🌏 docs.icegl.cn

3D Editor: [📊 Native editor + plugin generator]	UI Editor: [📊 GoView export + config import component]
uniapp Mini Program Ecosystem: [One codebase across platforms]	qiankun Micro Frontend: [Integrate quickly into your existing project]

🧩 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

❓ Feedback & Support

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

⭐ Star History

™️ Copyright Information

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.

1. 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.

2. 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.

3. 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.