@collabdt/core
v0.7.0
Published
CDT Core contains all the core technology for your CDT platform
Readme
What is CDT?
Collab Digital Twins powers web-based, non-proprietary platforms for visualizing and interacting with multi-scale geospatial information systems (GIS), open data, and open building information modelling (BIM), alongside text, images, static and animated 3D models, IFCs, and point clouds.
The stack uses React for the interface, state management, and memory optimization, and Next.js for routing and server-side rendering, integrating open-source packages for maps and 3D. See the architecture overview for the full tech stack.
CDT fetches multi-scale open data (federal, provincial, municipal) directly from organizational APIs without local storage. It is not a system of record — it is a framework for referencing and linking distributed data sources.
An authentication system lets users form groups, assume roles with scoped credentials for controlled data and feature access, collaborate, and contribute media publicly or privately.
Mission
CDT bridges BIM and GIS using open standards and free and open-source technologies, letting stakeholders visualize and analyze data directly in the browser without proprietary barriers.
The project is stewarded by Collab Digital Twins, a Canadian not-for-profit established to promote openness, innovation, and long-term public benefit.
Deployment
CDT can be run in two ways, depending on how much infrastructure you want to manage. See the Deployment overview for full details.
- Self-Hosting — run the full stack on your own infrastructure with Docker or Podman. You retain full control over data and configuration. Best for organizations with existing IT capacity that require data sovereignty or custom configuration. The Services reference covers the components involved: PostgreSQL, MinIO, Martin/PostGIS, Node/Next.js, and the Open Data Service.
- CDT Hosted — a fully managed SaaS deployment hosted in Canada, or an assisted deployment where the CDT team installs CDT on your infrastructure. Best for organizations with limited IT resources.
If you self-host CDT for others over a network, note the AGPL §13 source-availability obligation described under Licensing.
Contributing
Community contributions are welcome.
- Read the Contributor Guide to get started.
- Read the Contributor Terms and sign the Contributor License Agreement (CLA) before submitting.
Because CDT is dual-licensed (see Licensing), every contributor signs the CLA. You keep the copyright in your contribution and grant Collab Digital Twins the right to distribute it under both the AGPL-3.0 and our commercial terms. You are prompted to sign automatically on your first pull request.
Licensing
Open source — AGPL-3.0
Free and open source under the GNU Affero General Public License, version 3.0 (full text · summary). You may use, study, modify, and redistribute it under those terms at no cost.
The AGPL is a strong copyleft license with one obligation that is easy to miss: it applies to anyone who runs the software as a network service (AGPL §13). If you make CDT (modified or not) available to others over a network, those users must be able to obtain the complete corresponding source code of the exact version you run. In practice:
- Self-hosting for others: offer users the corresponding source, typically via a visible "Source" link in the running application pointing to the public repository at the deployed version.
- Modifications: any changes you distribute or host must also be licensed under AGPL-3.0.
If those terms work for you, self-host with no further obligation to us. For commercial licensing or a support agreement, contact [email protected].
Copyright © 2025 Collab Digital Twins. Distributed under AGPL-3.0; see LICENSE and third-party attributions in NOTICE.
Beta Access
To participate in the beta, complete the beta access form. We review submissions and follow up with onboarding details.
