From c18c01b559a1baf049349faaad05a6249749dee4 Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Tue, 29 Sep 2026 19:28:45 -0400 Subject: [PATCH 1/4] Document the browser Local Drive file picker --- .../features/data-management/import.mdx | 24 +++++++++++-------- 1 file changed, 14 insertions(+), 10 deletions(-) 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 ed03adba..0a33d891 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 @@ -14,8 +14,8 @@ model's KCL code so its geometry can appear in the Scene. ## Add File to Project -Choose one of the methods below to add files. In the browser, use **drag and drop** for files on your -computer. The **Local Drive** picker is available only in the desktop app. +Choose one of the methods below to add files from your computer or the sample library. +Drag and drop and the **Local Drive** picker are available in both the browser and desktop app. ### Drag and Drop (Browser and Desktop) @@ -27,20 +27,24 @@ computer. The **Local Drive** picker is available only in the desktop app. For ZIP archives, unzip them on your computer first, then drag the extracted files and folders into **Project Files**. Keep the folder structure intact so relative file references continue to work. -### Local Drive Picker (Desktop Only) +### Local Drive Picker (Browser and Desktop) -1. Open the Command Bar. -2. Select **Add file to project**. -3. Choose **Local Drive** as the source. -4. Choose a new or existing project and enter or select its name. -5. Browse to the file location. -6. Select the file to add. +1. Open a project, or create and open a new project. +2. Open the Command Bar. +3. Select **Add file to project**. +4. Choose **Local Drive** as the source. +5. Select the destination project if prompted. The desktop app also lets you create a new project. +6. Click **Open file**, browse to the file location, and select the file to add. +7. Submit the command. + +The picker adds one file at a time. Use drag and drop to add multiple files or folders. +An added `.kcl` file opens in the Code Editor; other files appear in **Project Files**. ### KCL Samples (Browser and Desktop) 1. Open the Command Bar. 2. Select **Add file to project**. -3. Choose **KCL Samples** as the source if prompted. In the browser, this source is selected automatically. +3. Choose **KCL Samples** as the source. 4. Select a sample from the library. 5. Select the destination project. The desktop app also lets you create a new project from the sample. From 75b3b31626bc5f003aea3159d4fba9538664f4e1 Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Thu, 1 Oct 2026 09:42:47 -0400 Subject: [PATCH 2/4] Describe automatic Local Drive picker opening --- .../docs/zoo-design-studio/features/data-management/import.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 0a33d891..5d085ac8 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 @@ -34,7 +34,7 @@ For ZIP archives, unzip them on your computer first, then drag the extracted fil 3. Select **Add file to project**. 4. Choose **Local Drive** as the source. 5. Select the destination project if prompted. The desktop app also lets you create a new project. -6. Click **Open file**, browse to the file location, and select the file to add. +6. In the file picker, browse to the file location and select the file to add. Click **Open file** to reopen the picker if needed. 7. Submit the command. The picker adds one file at a time. Use drag and drop to add multiple files or folders. From d6b36346cd535cae1c5923972067f68037f9b383 Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Thu, 1 Oct 2026 13:15:23 -0400 Subject: [PATCH 3/4] Document browser imports into new projects --- .../features/data-management/import.mdx | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) 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 5d085ac8..542c3e8f 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 @@ -29,13 +29,12 @@ For ZIP archives, unzip them on your computer first, then drag the extracted fil ### Local Drive Picker (Browser and Desktop) -1. Open a project, or create and open a new project. -2. Open the Command Bar. -3. Select **Add file to project**. -4. Choose **Local Drive** as the source. -5. Select the destination project if prompted. The desktop app also lets you create a new project. -6. In the file picker, browse to the file location and select the file to add. Click **Open file** to reopen the picker if needed. -7. Submit the command. +1. Open the Command Bar. +2. Select **Add file to project**. +3. Choose **Local Drive** as the source. +4. Choose **New project** and enter a name, or choose **Existing project** and select a project if prompted. +5. In the file picker, browse to the file location and select the file to add. Click **Open file** to reopen the picker if needed. +6. Submit the command. The picker adds one file at a time. Use drag and drop to add multiple files or folders. An added `.kcl` file opens in the Code Editor; other files appear in **Project Files**. @@ -46,7 +45,7 @@ An added `.kcl` file opens in the Code Editor; other files appear in **Project F 2. Select **Add file to project**. 3. Choose **KCL Samples** as the source. 4. Select a sample from the library. -5. Select the destination project. The desktop app also lets you create a new project from the sample. +5. Choose **New project** and enter a name, or choose **Existing project** and select a project if prompted. Once your files are in the project, continue below to import one into a model. To edit a `.kcl` file as its own model, open it directly from **Project Files**. From 8a47557918be7ffbcb3174854883544e81dc3d61 Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Thu, 1 Oct 2026 15:50:22 -0400 Subject: [PATCH 4/4] Require an open project for adding files --- .../features/data-management/import.mdx | 26 +++++++++++-------- 1 file changed, 15 insertions(+), 11 deletions(-) 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 542c3e8f..a6f5955f 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 @@ -29,23 +29,27 @@ For ZIP archives, unzip them on your computer first, then drag the extracted fil ### Local Drive Picker (Browser and Desktop) -1. Open the Command Bar. -2. Select **Add file to project**. -3. Choose **Local Drive** as the source. -4. Choose **New project** and enter a name, or choose **Existing project** and select a project if prompted. -5. In the file picker, browse to the file location and select the file to add. Click **Open file** to reopen the picker if needed. -6. Submit the command. +1. Open a project, or create and open a new project. +2. Open the Command Bar. +3. Select **Add file to project**. +4. Choose **Local Drive** as the source. +5. Select the destination project if prompted. +6. In the file picker, browse to the file location and select the file to add. Click **Open file** to reopen the picker if needed. +7. Submit the command. The picker adds one file at a time. Use drag and drop to add multiple files or folders. An added `.kcl` file opens in the Code Editor; other files appear in **Project Files**. ### KCL Samples (Browser and Desktop) -1. Open the Command Bar. -2. Select **Add file to project**. -3. Choose **KCL Samples** as the source. -4. Select a sample from the library. -5. Choose **New project** and enter a name, or choose **Existing project** and select a project if prompted. +1. Open a project, or create and open a new project. +2. Open the Command Bar. +3. Select **Add file to project**. +4. Choose **KCL Samples** as the source. +5. Select a sample from the library. +6. Select the destination project if prompted. + +To create a new project from a sample, use **Create from a sample** on the Home page. Once your files are in the project, continue below to import one into a model. To edit a `.kcl` file as its own model, open it directly from **Project Files**.