From 1453b78f4ae058c4271d1892f382f14b44e69123 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:21:30 +0800 Subject: [PATCH 01/20] Add note about Blockly v13 for the codelab Clarify the target version of Blockly for the codelab.docs: add Blockly v13 note to context-menu-option codelab --- packages/docs/docs/codelabs/context-menu-option/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/context-menu-option/setup.mdx b/packages/docs/docs/codelabs/context-menu-option/setup.mdx index 69baa6d37a1..096107e9a28 100644 --- a/packages/docs/docs/codelabs/context-menu-option/setup.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/setup.mdx @@ -35,3 +35,4 @@ const storageKey = 'contextMenuWorkspace'; Take a moment to explore the code you just created in the `context-menu-option-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. +> **Note:** This codelab is targeted for Blockly v13. From 8065b086dd19141562fa03ef258306a04d9a2eca Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:22:53 +0800 Subject: [PATCH 02/20] Add note for Blockly v13 target version Added a note about the codelab's target version. --- packages/docs/docs/codelabs/css/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/css/setup.mdx b/packages/docs/docs/codelabs/css/setup.mdx index cfc9220726f..08d7d0a8f8e 100644 --- a/packages/docs/docs/codelabs/css/setup.mdx +++ b/packages/docs/docs/codelabs/css/setup.mdx @@ -48,3 +48,4 @@ The pieces that matter most for this codelab are: - `src/toolbox.js` - defines the toolbox's categories. You'll add a CSS class to each category so you can target it with a CSS rule. - `src/index.js` - injects the workspace. You'll import your new stylesheet here. +> **Note:** This codelab is targeted for Blockly v13. From d186377ba5b458a34c1049ef5443b867479642d8 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:23:51 +0800 Subject: [PATCH 03/20] Update note for Blockly version in setup.mdx Clarified that the codelab is targeted for Blockly v13. --- packages/docs/docs/codelabs/custom-generator/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-generator/setup.mdx b/packages/docs/docs/codelabs/custom-generator/setup.mdx index b7dc071de90..143d0d8315b 100644 --- a/packages/docs/docs/codelabs/custom-generator/setup.mdx +++ b/packages/docs/docs/codelabs/custom-generator/setup.mdx @@ -176,3 +176,4 @@ If the server is already running, refresh the page to see changes. Otherwise, ru /> The app is still trying to generate and run JavaScript for the workspace, instead of JSON. The next section changes that. +> **Note:** This codelab is targeted for Blockly v13. From 046277414d0b32647c223202572da6c8521e01d2 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:24:39 +0800 Subject: [PATCH 04/20] Update setup.mdx --- packages/docs/docs/codelabs/custom-mutator/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-mutator/setup.mdx b/packages/docs/docs/codelabs/custom-mutator/setup.mdx index 0d7d79fe649..9a8df9222a9 100644 --- a/packages/docs/docs/codelabs/custom-mutator/setup.mdx +++ b/packages/docs/docs/codelabs/custom-mutator/setup.mdx @@ -35,3 +35,4 @@ const storageKey = 'customMutatorWorkspace'; Take a moment to explore the code you just created in the `custom-mutator-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. +> **Note:** This codelab is targeted for Blockly v13. From fc1905c3825bf04f96f5142c304fec39b672a808 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:25:12 +0800 Subject: [PATCH 05/20] Add note about Blockly v13 target version Added a note indicating that the codelab is targeted for Blockly v13. --- packages/docs/docs/codelabs/custom-renderer/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-renderer/setup.mdx b/packages/docs/docs/codelabs/custom-renderer/setup.mdx index 17133b056c6..cc50a857192 100644 --- a/packages/docs/docs/codelabs/custom-renderer/setup.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/setup.mdx @@ -35,3 +35,4 @@ const storageKey = 'customRendererWorkspace'; Take a moment to explore the code you just created in the `custom-renderer-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. +> **Note:** This codelab is targeted for Blockly v13. From 474b3c3fac7d766542d1d042652f0eb72b0ef93a Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:25:33 +0800 Subject: [PATCH 06/20] Update setup.mdx --- packages/docs/docs/codelabs/custom-toolbox/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-toolbox/setup.mdx b/packages/docs/docs/codelabs/custom-toolbox/setup.mdx index ac3ef301e9f..e3e00f1adec 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/setup.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/setup.mdx @@ -39,3 +39,4 @@ const storageKey = 'customToolboxWorkspace'; Take a moment to explore the code you just created in the `custom-toolbox-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. +> **Note:** This codelab is targeted for Blockly v13. From 532eb9ad0ae6a02ff5ba799565b3dae3f2ac206b Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:25:59 +0800 Subject: [PATCH 07/20] Update setup.mdx --- packages/docs/docs/codelabs/getting-started/setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/docs/docs/codelabs/getting-started/setup.mdx b/packages/docs/docs/codelabs/getting-started/setup.mdx index f9d30aeecd4..fec0d0ba014 100644 --- a/packages/docs/docs/codelabs/getting-started/setup.mdx +++ b/packages/docs/docs/codelabs/getting-started/setup.mdx @@ -31,4 +31,4 @@ The starter code folder contains: - `package-lock.json`: Keeps track of the dependencies. - `package.json`: Stores basic information about the app. - `webpack.config.js`: The configuration for webpack, which handles the application bundling and running the server. - +> **Note:** This codelab is targeted for Blockly v13. From dee512d44043375c5a27253788dd55a99c32e92f Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:26:28 +0800 Subject: [PATCH 08/20] Update setup.mdx --- packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx index d1f0f4ff03b..6d06013f5c3 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx @@ -47,3 +47,4 @@ Open the window with your running app. You should see a Blockly workspace with a alt="The Blockly sample app with a default-themed workspace and toolbox." className="codelabImage" /> +> **Note:** This codelab is targeted for Blockly v13. From 13eff48b155a1b79a9983589085a23cbd6bcdca1 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:27:00 +0800 Subject: [PATCH 09/20] Add note about Blockly v13 target version Clarify the target version for the codelab. --- packages/docs/docs/codelabs/validation-and-warnings/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx b/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx index 252cac0b79a..1c074102b6a 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx @@ -41,3 +41,4 @@ The pieces that matter most for this codelab are: - `src/generators/javascript.js` - defines how to generate JavaScript code from the custom blocks. - `src/toolbox.js` - defines which blocks are available in the toolbox. - `src/index.js` - registers the blocks and generators, injects the workspace, and re-runs the generated code whenever the workspace changes. +> **Note:** This codelab is targeted for Blockly v13. From 8f036f8e7dbe91523d07e56369b61057a4f840d7 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:32:41 +0800 Subject: [PATCH 10/20] Specify Blockly version requirement for new codelabs Added a note to specify the Blockly version for new codelabs. --- packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx b/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx index 59df60b870c..046bc31ba8f 100644 --- a/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx +++ b/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx @@ -68,7 +68,7 @@ writing a codelab. [getting started codelab](/codelabs/getting-started/codelab-overview) already explain its code. - What is the minimum setup required for the user to run your code? - +New codelabs should state the version of Blockly they are written for. ### Structure As with any writing, start with an outline. This is a good structure for most From 2a9e499f55b57a3ce551962e4f1900475ff0c573 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:33:41 +0800 Subject: [PATCH 11/20] Update setup.mdx --- packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx b/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx index 6d06013f5c3..c4a7a32c126 100644 --- a/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx +++ b/packages/docs/docs/codelabs/theme-extension-identifier/setup.mdx @@ -47,4 +47,5 @@ Open the window with your running app. You should see a Blockly workspace with a alt="The Blockly sample app with a default-themed workspace and toolbox." className="codelabImage" /> + > **Note:** This codelab is targeted for Blockly v13. From 021316bdc905ae70432435796825cb9b8a5839d9 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 08:49:37 +0800 Subject: [PATCH 12/20] Add note about Blockly v13 target version Added a note about the target version of Blockly for the codelab. --- packages/docs/docs/codelabs/context-menu-option/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/context-menu-option/setup.mdx b/packages/docs/docs/codelabs/context-menu-option/setup.mdx index 096107e9a28..30daf8e36c8 100644 --- a/packages/docs/docs/codelabs/context-menu-option/setup.mdx +++ b/packages/docs/docs/codelabs/context-menu-option/setup.mdx @@ -35,4 +35,5 @@ const storageKey = 'contextMenuWorkspace'; Take a moment to explore the code you just created in the `context-menu-option-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. + > **Note:** This codelab is targeted for Blockly v13. From c31946a161a0c7eb89e2569da640c722d18ab883 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:15:26 +0800 Subject: [PATCH 13/20] Update setup.mdx --- packages/docs/docs/codelabs/css/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/css/setup.mdx b/packages/docs/docs/codelabs/css/setup.mdx index 08d7d0a8f8e..64713ad5604 100644 --- a/packages/docs/docs/codelabs/css/setup.mdx +++ b/packages/docs/docs/codelabs/css/setup.mdx @@ -48,4 +48,5 @@ The pieces that matter most for this codelab are: - `src/toolbox.js` - defines the toolbox's categories. You'll add a CSS class to each category so you can target it with a CSS rule. - `src/index.js` - injects the workspace. You'll import your new stylesheet here. + > **Note:** This codelab is targeted for Blockly v13. From 8cb9ec9836fd753c23cdc361c7e74943cd68d53f Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:16:06 +0800 Subject: [PATCH 14/20] Update setup.mdx --- packages/docs/docs/codelabs/custom-generator/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-generator/setup.mdx b/packages/docs/docs/codelabs/custom-generator/setup.mdx index 143d0d8315b..9301b918a87 100644 --- a/packages/docs/docs/codelabs/custom-generator/setup.mdx +++ b/packages/docs/docs/codelabs/custom-generator/setup.mdx @@ -176,4 +176,5 @@ If the server is already running, refresh the page to see changes. Otherwise, ru /> The app is still trying to generate and run JavaScript for the workspace, instead of JSON. The next section changes that. + > **Note:** This codelab is targeted for Blockly v13. From 7cfabbc59a107c7c04af653e8258b52c81683559 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:16:27 +0800 Subject: [PATCH 15/20] Update setup.mdx --- packages/docs/docs/codelabs/custom-mutator/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-mutator/setup.mdx b/packages/docs/docs/codelabs/custom-mutator/setup.mdx index 9a8df9222a9..8b9d79341dc 100644 --- a/packages/docs/docs/codelabs/custom-mutator/setup.mdx +++ b/packages/docs/docs/codelabs/custom-mutator/setup.mdx @@ -35,4 +35,5 @@ const storageKey = 'customMutatorWorkspace'; Take a moment to explore the code you just created in the `custom-mutator-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. + > **Note:** This codelab is targeted for Blockly v13. From c97cea9a9a34732d1b0b505f4ebcb1838aff747a Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:16:49 +0800 Subject: [PATCH 16/20] Update setup.mdx --- packages/docs/docs/codelabs/custom-renderer/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-renderer/setup.mdx b/packages/docs/docs/codelabs/custom-renderer/setup.mdx index cc50a857192..1f66f521cd7 100644 --- a/packages/docs/docs/codelabs/custom-renderer/setup.mdx +++ b/packages/docs/docs/codelabs/custom-renderer/setup.mdx @@ -35,4 +35,5 @@ const storageKey = 'customRendererWorkspace'; Take a moment to explore the code you just created in the `custom-renderer-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. + > **Note:** This codelab is targeted for Blockly v13. From 80ea6b79e0567cb0327c0eb160d7121bb725ab62 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:17:19 +0800 Subject: [PATCH 17/20] Update setup.mdx --- packages/docs/docs/codelabs/custom-toolbox/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/custom-toolbox/setup.mdx b/packages/docs/docs/codelabs/custom-toolbox/setup.mdx index e3e00f1adec..d8f6d2c81aa 100644 --- a/packages/docs/docs/codelabs/custom-toolbox/setup.mdx +++ b/packages/docs/docs/codelabs/custom-toolbox/setup.mdx @@ -39,4 +39,5 @@ const storageKey = 'customToolboxWorkspace'; Take a moment to explore the code you just created in the `custom-toolbox-codelab` folder. If you'd like a more in-depth explanation of all of the code in the sample app, check out the [getting started codelab](/codelabs/getting-started/codelab-overview) which goes through creating this sample app from scratch. For a briefer outline of the code, visit the [sample app overview](/guides/get-started/sample-app-overview/) page for an overview of the included files and tooling. + > **Note:** This codelab is targeted for Blockly v13. From 6106d9c04c41aa02c97de0bfded197091aa9b499 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:17:43 +0800 Subject: [PATCH 18/20] Update setup.mdx --- packages/docs/docs/codelabs/getting-started/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/getting-started/setup.mdx b/packages/docs/docs/codelabs/getting-started/setup.mdx index fec0d0ba014..a67a929884e 100644 --- a/packages/docs/docs/codelabs/getting-started/setup.mdx +++ b/packages/docs/docs/codelabs/getting-started/setup.mdx @@ -31,4 +31,5 @@ The starter code folder contains: - `package-lock.json`: Keeps track of the dependencies. - `package.json`: Stores basic information about the app. - `webpack.config.js`: The configuration for webpack, which handles the application bundling and running the server. + > **Note:** This codelab is targeted for Blockly v13. From b0b56746c5d2803228b3e370153b3286513d102c Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:18:03 +0800 Subject: [PATCH 19/20] Update setup.mdx --- packages/docs/docs/codelabs/validation-and-warnings/setup.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx b/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx index 1c074102b6a..509e3e08727 100644 --- a/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx +++ b/packages/docs/docs/codelabs/validation-and-warnings/setup.mdx @@ -41,4 +41,5 @@ The pieces that matter most for this codelab are: - `src/generators/javascript.js` - defines how to generate JavaScript code from the custom blocks. - `src/toolbox.js` - defines which blocks are available in the toolbox. - `src/index.js` - registers the blocks and generators, injects the workspace, and re-runs the generated code whenever the workspace changes. + > **Note:** This codelab is targeted for Blockly v13. From 9caac8e963818f5b56785d1789ef0543611165b6 Mon Sep 17 00:00:00 2001 From: guitarmanchan911-byte Date: Tue, 10 Nov 2026 09:22:40 +0800 Subject: [PATCH 20/20] Update write_a_codelab.mdx --- packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx b/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx index 046bc31ba8f..8ff16947b1f 100644 --- a/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx +++ b/packages/docs/docs/guides/contribute/docs/write_a_codelab.mdx @@ -68,7 +68,9 @@ writing a codelab. [getting started codelab](/codelabs/getting-started/codelab-overview) already explain its code. - What is the minimum setup required for the user to run your code? + New codelabs should state the version of Blockly they are written for. + ### Structure As with any writing, start with an outline. This is a good structure for most