From d7ef4f6f30e5d52340e4abfab452b7da563b3f27 Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Wed, 9 Sep 2026 16:57:21 -0400 Subject: [PATCH 1/3] Align documentation with the Import command rename --- .../features/3d-design/assemblies/index.mdx | 2 +- .../3d-design/assemblies/insert/index.mdx | 7 ++++--- .../features/data-management/import.mdx | 19 ++----------------- .../features/data-management/import/step.mdx | 6 +++--- .../features/workspace/command-bar.mdx | 4 +--- .../zoo-design-studio/getting-started.mdx | 2 +- 6 files changed, 12 insertions(+), 28 deletions(-) diff --git a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx index 0a0ec59bd..8f31da5f7 100644 --- a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx +++ b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx @@ -8,4 +8,4 @@ Assemblies define how separate parts are positioned and oriented within a single Current assembly workflows focus on inserting single-body parts into the main assembly. Nested subassemblies and broader multi-body insertion workflows are not yet part of the supported assembly flow. For the current in-app workflow, start with -[Insert](/docs/zoo-design-studio/features/3d-design/assemblies/insert). +[Import](/docs/zoo-design-studio/features/3d-design/assemblies/insert). diff --git a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx index bbf860c31..3b35b1430 100644 --- a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx +++ b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx @@ -1,10 +1,11 @@ --- -title: Insert -excerpt: Insert workflows for assemblies in Zoo Design Studio. +title: Import +excerpt: Import workflows for assemblies in Zoo Design Studio. sidebarPosition: 0 --- -Insert is the current point-and-click assembly workflow in Zoo Design Studio. Use it to place an +Import is the current point-and-click assembly workflow in Zoo Design Studio. Use it to place an existing single-body part into the active main assembly so it can be positioned and referenced. +The Import command generates a KCL `import` statement for the selected project file. Current support is focused on single-body part insertion, not nested subassemblies or broader multi-body assembly structures. diff --git a/content/pages/docs/zoo-design-studio/features/data-management/import.mdx b/content/pages/docs/zoo-design-studio/features/data-management/import.mdx index 9ff643555..24244d547 100644 --- a/content/pages/docs/zoo-design-studio/features/data-management/import.mdx +++ b/content/pages/docs/zoo-design-studio/features/data-management/import.mdx @@ -116,22 +116,7 @@ Use the **Add file to project** command to import local files or Zoo sample mode 4. Select sample from library 5. Choose to add to current or new project -### Import File from URL - -Import remote files directly from web URLs: - -1. Open Command Bar -2. Select "Import file from URL" -3. Specify import method (add to current or create new project) -4. Enter remote file URL -5. Specify filename and optional project name - -Supported URL formats: -- Direct file links (https://example.com/model.step) -- Cloud storage shared links (Google Drive, Dropbox, OneDrive) -- Repository raw file URLs (GitHub, GitLab) - -### Insert Command (KCL) +### Import Command (KCL) Reference existing project files from within KCL code: @@ -146,7 +131,7 @@ import utils from "./library/utils.kcl" import reference from "./reference/concept.glb" ``` -The `Insert` command (available via Command Bar) provides a UI workflow for the same functionality: +The `Import` command (available via Command Bar and the toolbar) provides a UI workflow for the same functionality: 1. Select file from project directory 2. Specify local variable name for the imported geometry 3. KCL import statement is automatically generated diff --git a/content/pages/docs/zoo-design-studio/features/data-management/import/step.mdx b/content/pages/docs/zoo-design-studio/features/data-management/import/step.mdx index 6626879e4..12ce1494d 100644 --- a/content/pages/docs/zoo-design-studio/features/data-management/import/step.mdx +++ b/content/pages/docs/zoo-design-studio/features/data-management/import/step.mdx @@ -50,19 +50,19 @@ before referencing it from KCL. ## Add the STEP import to KCL -With the STEP file in Project Files, use the insert action to add the import statement to the +With the STEP file in Project Files, use the Import action to add the import statement to the active KCL file. Zoo Design Studio writes the import line for you, so you do not need to type the filename manually.
- Use the insert action from Project Files to add the STEP import line to `main.kcl` + Use the Import action from Project Files to add the STEP import line to `main.kcl`
## Recommended KCL syntax diff --git a/content/pages/docs/zoo-design-studio/features/workspace/command-bar.mdx b/content/pages/docs/zoo-design-studio/features/workspace/command-bar.mdx index 040fa26c4..d12c93a5c 100644 --- a/content/pages/docs/zoo-design-studio/features/workspace/command-bar.mdx +++ b/content/pages/docs/zoo-design-studio/features/workspace/command-bar.mdx @@ -66,8 +66,6 @@ Settings commands control application preferences, display options, and modeling **Rename project:** Change project name (old name → new name). -**Import file from URL:** Import remote files into project (STEP, KCL, etc.). - ### File Operations Commands **Add file to project:** Import local files or Zoo samples into project. @@ -136,7 +134,7 @@ Parameters: **Set experimental features flag:** Enable/disable experimental KCL features (`warn`, `allow`, `none`). -**Insert:** Import from project file (STEP, GLB, FBX, KCL) with local variable binding. +**Import:** Import from project file (STEP, GLB, FBX, KCL) with local variable binding. **Format Code:** Apply standard formatting to KCL code editor content. diff --git a/content/pages/docs/zoo-design-studio/getting-started.mdx b/content/pages/docs/zoo-design-studio/getting-started.mdx index 3955d9010..33d73011a 100644 --- a/content/pages/docs/zoo-design-studio/getting-started.mdx +++ b/content/pages/docs/zoo-design-studio/getting-started.mdx @@ -178,6 +178,6 @@ Click Create from Sample on the project dashboard to browse available KCL exampl Zoo Design Studio supports various file formats for interoperability with other CAD systems: -- **Importing**: Add external models to your project by selecting Insert from the top command bar. Supported formats include `STEP`, `.sldprt` and `STL`. For further details see the [KCL docs](https://zoo.dev/docs/kcl-lang/foreign-imports). +- **Importing**: Add external models to your project by selecting Import from the top command bar. Supported formats include `STEP`, `.sldprt` and `STL`. For further details see the [KCL docs](https://zoo.dev/docs/kcl-lang/foreign-imports). - **Exporting**: Save your designs for use in other applications by choosing File → Export and selecting your desired format: `STEP`, `STL`, `gLTF`, `OBJ`, or `PLY`. - For models created with Zookeeper, your generated geometry is automatically saved in the project folder and can be exported to any supported format at any time. From fd19d2fe266d81c8d0e312129cfaca8866baa08d Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Thu, 17 Sep 2026 09:50:35 -0400 Subject: [PATCH 2/3] Document Import's former Insert name --- .../docs/zoo-design-studio/features/data-management/import.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/pages/docs/zoo-design-studio/features/data-management/import.mdx b/content/pages/docs/zoo-design-studio/features/data-management/import.mdx index 24244d547..2ea124b68 100644 --- a/content/pages/docs/zoo-design-studio/features/data-management/import.mdx +++ b/content/pages/docs/zoo-design-studio/features/data-management/import.mdx @@ -118,6 +118,8 @@ Use the **Add file to project** command to import local files or Zoo sample mode ### Import Command (KCL) +Previously named **Insert**, the **Import** command can be found by searching for either name in the Command Bar. + Reference existing project files from within KCL code: ```kcl From 6e4f748c15e890da67deb937c2270783ff9e144e Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Mon, 21 Sep 2026 12:45:25 -0400 Subject: [PATCH 3/3] Last fix --- .../features/3d-design/assemblies/{insert => import}/index.mdx | 0 .../zoo-design-studio/features/3d-design/assemblies/index.mdx | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) rename content/pages/docs/zoo-design-studio/features/3d-design/assemblies/{insert => import}/index.mdx (100%) diff --git a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/import/index.mdx similarity index 100% rename from content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx rename to content/pages/docs/zoo-design-studio/features/3d-design/assemblies/import/index.mdx diff --git a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx index 8f31da5f7..10a5444ba 100644 --- a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx +++ b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/index.mdx @@ -8,4 +8,4 @@ Assemblies define how separate parts are positioned and oriented within a single Current assembly workflows focus on inserting single-body parts into the main assembly. Nested subassemblies and broader multi-body insertion workflows are not yet part of the supported assembly flow. For the current in-app workflow, start with -[Import](/docs/zoo-design-studio/features/3d-design/assemblies/insert). +[Import](/docs/zoo-design-studio/features/3d-design/assemblies/import).