diff --git a/CONTENT-LICENSE.md b/CONTENT-LICENSE.md
new file mode 100644
index 00000000..34feb605
--- /dev/null
+++ b/CONTENT-LICENSE.md
@@ -0,0 +1,33 @@
+# Content & Asset Licensing
+
+This repository uses a split licensing model:
+
+## MIT License (Code)
+
+All source code in the following directories is licensed under the [MIT License](./LICENSE):
+
+- `packages/` — All NPM package source code
+- `languages/` — Language/localization files
+- `examples/` — Example application source code
+- `docs/src/` — Docusaurus site source code (React components, config, scripts)
+
+## Documentation Text (CC BY 4.0)
+
+The written documentation content in `docs/` (Markdown files in `docs/learn/`, `docs/api/`, `docs/blog/`) is licensed under the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/). You are free to share and adapt the text with attribution.
+
+## Not Licensed (Trademarks & Third-Party Assets)
+
+The following assets are **NOT** covered by the MIT license or any open-source/permissive license:
+
+- **Bitbybit logos and branding** — The Bitbybit name, logos, and brand assets (including files in `docs/static/img/`) are trademarks of Bit by bit developers. All rights reserved.
+- **Client/partner logos and trademarks** — Logos and trademarks of third-party companies appearing in blog posts, documentation, or static assets remain the property of their respective owners and are used with permission for informational purposes only.
+- **Blog post images** — Photographs, illustrations, and media in `docs/blog/` that are not code snippets may be subject to separate copyright.
+
+### What This Means
+
+- ✅ You **can** freely use, modify, and distribute all source code under MIT
+- ✅ You **can** share and adapt documentation text with attribution (CC BY 4.0)
+- ❌ You **cannot** use Bitbybit or third-party logos/trademarks without permission
+- ❌ You **cannot** imply endorsement by Bitbybit or its clients
+
+If you have questions about using any assets, please open an issue or contact us.
diff --git a/README.md b/README.md
index 96e6d630..f873262c 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,10 @@
Open-source 3D CAD algorithms for the web - MIT licensed. This monorepo contains all Bitbybit NPM packages plus example applications.
+## License
+
+Source code in `packages/`, `languages/`, and `examples/` is [MIT licensed](./LICENSE). Documentation text in `docs/` is [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Logos, trademarks, and media assets are **not** open-source — see [CONTENT-LICENSE.md](./CONTENT-LICENSE.md) for details.
+
# [FULL PLATFORM AT BITBYBIT.DEV](https://bitbybit.dev)
# [LEARN BITBYBIT](https://learn.bitbybit.dev)
diff --git a/docs/blog/2026-05-10-bitbybit-v1-release.mdx b/docs/blog/2026-05-10-bitbybit-v1-release.mdx
index 853485f7..b072ceda 100644
--- a/docs/blog/2026-05-10-bitbybit-v1-release.mdx
+++ b/docs/blog/2026-05-10-bitbybit-v1-release.mdx
@@ -9,7 +9,7 @@ image: /img/blog/bitbybit-v1.webp
import ImageGallery from '@site/src/components/ImageGallery';
-
+
After nearly **100 releases** in the 0.x.x range and a release candidate phase, **Bitbybit v1.0.0** is officially here. This release brings our new CAD foundation, cloud infrastructure, and an expanded toolkit for developers.
@@ -23,6 +23,20 @@ This post outlines the major architectural changes and new capabilities availabl
altPrefix="BITBYBIT CAD PLATFORM OVERVIEW"
/>
+Check out this in-depth dive into Bitbybit platform. Matas shows how various parts of Bitbybit can be used in your websites.
+
+
+
+
+
## Native OCCT 8 Kernel
The biggest change in v1.0.0 happens under the hood. We have transitioned away from our OpenCascade.js dependency and rebuilt Bitbybit's core directly on top of the native [OCCT C++ library](https://github.com/Open-Cascade-SAS/OCCT). By compiling directly to WebAssembly with bindings customized for Bitbybit, we've improved overall performance and maintainability.
diff --git a/docs/learn/intro.md b/docs/learn/intro.md
index 3d0a5913..a48a6848 100644
--- a/docs/learn/intro.md
+++ b/docs/learn/intro.md
@@ -56,6 +56,20 @@ Most of our users - developers and enterprise clients alike - want to bring inte
altPrefix="Bitbybit Platform Architecture"
/>
+In this deep dive, Matas walks through the diagram above in detail - explaining each integration path with live examples and showing how Bitbybit fits into your website architecture.
+
+
+
+
+
Each path connects your website to a different layer of the Bitbybit ecosystem:
### Option 1: Bitbybit Runners
diff --git a/docs/learn/open-source-approach.md b/docs/learn/open-source-approach.md
index 9f84d3ad..6dc49b93 100644
--- a/docs/learn/open-source-approach.md
+++ b/docs/learn/open-source-approach.md
@@ -12,7 +12,7 @@ import Admonition from '@theme/Admonition';
At Bitbybit, we believe in the power of open source and community collaboration. However, to sustain and grow the platform, some components remain proprietary. This page aims to clearly explain our approach so you know exactly what you can access, modify, and contribute to.
-**Our Guiding Principle:** If it's in our main [Bitbybit GitHub Monorepo](https://github.com/bitbybit-dev/bitbybit), it's open source!
+**Our Guiding Principle:** All source code in our main [Bitbybit GitHub Monorepo](https://github.com/bitbybit-dev/bitbybit) is open source (MIT). Documentation text is CC BY 4.0. Logos, trademarks, and media assets are not open-source — see [CONTENT-LICENSE.md](https://github.com/bitbybit-dev/bitbybit/blob/master/CONTENT-LICENSE.md) for the full breakdown.
## What IS Open Source in Bitbybit?
@@ -44,13 +44,20 @@ We are committed to open-sourcing the foundational elements that empower develop
* `bitbybit.jscad`
2. **Official Documentation:**
- * This Docusaurus-powered documentation site itself is open source. We encourage contributions to improve clarity and add examples!
+ * The Docusaurus site source code (`docs/src/`, config files, scripts) is MIT licensed.
+ * The written documentation text (Markdown in `docs/learn/`, `docs/api/`, `docs/blog/`) is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — you can share and adapt it with attribution.
+ * **However**, logos, trademarks, and media assets (images in `docs/static/img/`, blog post images) are **not** covered by any open-source or permissive license. Bitbybit logos are trademarks of Bit by bit developers, and client/partner logos remain the property of their respective owners. See [CONTENT-LICENSE.md](https://github.com/bitbybit-dev/bitbybit/blob/master/CONTENT-LICENSE.md) for full details.
+ * We encourage contributions to improve documentation clarity and add examples!
3. **Application Examples:**
- * We provide example projects and snippets demonstrating how to use our open-source NPM packages.
+ * We provide example projects and snippets demonstrating how to use our open-source NPM packages. The source code in `examples/` is MIT licensed.
+ * Note: examples may link to or reference assets (such as the Bitbybit logo) that are not themselves open-source.
+
+4. **Language/Localization Files:**
+ * All files in `languages/` are MIT licensed.
- The code for all the core building blocks-the mathematical and geometric engines, and fundamental utilities-is available for you to inspect, use, and even contribute to via our main GitHub monorepo.
+ The code for all the core building blocks — the mathematical and geometric engines, and fundamental utilities — is available for you to inspect, use, and even contribute to via our main GitHub monorepo. Documentation text is freely shareable under CC BY 4.0. Logos and trademarks are not open-source — see our [CONTENT-LICENSE.md](https://github.com/bitbybit-dev/bitbybit/blob/master/CONTENT-LICENSE.md) for the full breakdown.
## What is NOT Open Source (Proprietary Components)?
@@ -92,7 +99,8 @@ To support the development and hosting of the Bitbybit platform, certain compone
## Our Commitment to Transparency
We aim to be as transparent as possible about our open source model.
-* **The Rule of Thumb:** If you can't find the source code within the main [Bitbybit GitHub Monorepo](https://github.com/bitbybit-dev/bitbybit), it's likely proprietary and part of our intellectual property. Everything you can install via NPM - is open-source.
+* **The Rule of Thumb:** If you can't find the source code within the main [Bitbybit GitHub Monorepo](https://github.com/bitbybit-dev/bitbybit), it's likely proprietary and part of our intellectual property. Everything you can install via NPM is open-source.
+* **Trademarks & Assets:** Logos, brand assets, and third-party trademarks in the repository are **not** open-source, regardless of which directory they appear in. See [CONTENT-LICENSE.md](https://github.com/bitbybit-dev/bitbybit/blob/master/CONTENT-LICENSE.md) for specifics.
* **Why This Model?** This hybrid approach allows us to offer powerful core tools to the community while funding the ongoing development, maintenance, and innovation of the broader Bitbybit platform and its advanced features.
We appreciate your understanding and your engagement with both our open source contributions and the Bitbybit platform as a whole! If you have questions about specific components, feel free to reach out.
\ No newline at end of file
diff --git a/docs/static/LICENSE b/docs/static/LICENSE
new file mode 100644
index 00000000..8f213734
--- /dev/null
+++ b/docs/static/LICENSE
@@ -0,0 +1,10 @@
+The files in this directory (logos, images, and other media assets) are NOT
+covered by the repository's MIT license.
+
+- Bitbybit logos and brand assets are trademarks of Bit by bit developers.
+- Third-party logos and trademarks are property of their respective owners
+ and are used with permission for informational purposes only.
+
+All rights reserved. Do not use without explicit permission.
+
+See /CONTENT-LICENSE.md in the repository root for full details.
diff --git a/docs/static/img/blog/bitbybit-v1-new-base-for-cloud-and-web-cad.webp b/docs/static/img/blog/bitbybit-v1-new-base-for-cloud-and-web-cad.webp
new file mode 100644
index 00000000..0256d4a1
Binary files /dev/null and b/docs/static/img/blog/bitbybit-v1-new-base-for-cloud-and-web-cad.webp differ