update public_url setting

Author: matas-bitbybit-dev

docs/learn/3d-bits/tutorials/bitbybit-apps/settings.md

@@ -76,7 +76,7 @@ BITBYBIT APPS is designed exclusively for **frontend SPA development**. Any logi
 ## Available Settings
 
 ### Product-Specific Settings
-- [Public Script URL](#public-script-url)
+- [Public Script URL](#public-script-url) - [See full documentation](../getting-started/common-settings#public-script-url)
 
 ### Global Settings
 - [Show Spinner](#show-spinner)
@@ -112,9 +112,13 @@ Therefore, [Public Script URL](#public-script-url) usually remains **global** (s
 
 ## Public Script URL
 
+:::info Common Setting
+This setting is shared between RUNNER and APPS blocks. See [Public Script URL in Common Settings](../getting-started/common-settings#public-script-url) for general information about URL requirements, hosting options, and CORS configuration.
+:::
+
 The Public Script URL setting controls which JavaScript application the block loads, enabling the three-mode development workflow.
 
-### Three Development Modes
+### APPS-Specific: Three Development Modes
 
 The BITBYBIT APPS block supports three distinct modes:
 
@@ -200,41 +204,10 @@ Your Vite config must output:
 
 Our templates include the correct configuration. Custom setups should follow similar patterns.
 
-### Hosting Your Application
-
-**Recommended: Shopify CDN (Production)**
-- Upload via Content → Files in Shopify Admin
-- Automatic CDN distribution
-- No CORS issues
-- Free hosting included
-- Best performance for customers
-
-**Local Development/Preview**
-- Run Vite dev server on localhost:4242
-- No external hosting needed
-- HTTPS certificate required (handled by Vite)
-
-**Alternative Hosting Options** (less common):
-- **Cloud Storage**: AWS S3 + CloudFront, Google Cloud Storage
-- **CDN Services**: Cloudflare, jsDelivr
-- **Your Own Server**: Any HTTPS server with CORS headers
-
-:::warning Using Alternative Hosting
-If hosting outside Shopify, ensure proper CORS headers are configured. Shopify CDN is recommended for the simplest, most reliable setup.
+:::tip Hosting Options
+For hosting options and CORS requirements, see [Public Script URL in Common Settings](../getting-started/common-settings#public-script-url). For APPS, Shopify CDN is recommended for production, and localhost:4242 for development/preview.
 :::
 
-### CORS Requirements
-
-If your application is hosted on a different domain than your Shopify store, the server must return appropriate CORS headers:
-
-```
-Access-Control-Allow-Origin: *
-Access-Control-Allow-Methods: GET, OPTIONS
-Access-Control-Allow-Headers: Content-Type
-```
-
-Most CDN services handle this automatically.
-
 ### Application Structure with bits-pro
 
 Your application uses the **bits-pro NPM package** to communicate with the BITBYBIT APPS block:

docs/learn/3d-bits/tutorials/bitbybit-runner/settings.md

@@ -41,7 +41,7 @@ All editors are accessible through the **3D Bits admin dashboard** in your Shopi
 
 ### Script Configuration
 - [Inline Script](#inline-script)
-- [Public Script URL](#public-script-url)
+- [Public Script URL](#public-script-url) - [See full documentation](../getting-started/common-settings#public-script-url)
 - [Execute JavaScript](#execute-javascript)
 
 ### Geometry Kernel Options
@@ -121,48 +121,34 @@ Consider using a [Public Script URL](#public-script-url) if:
 
 ### Public Script URL
 
-The Public Script URL setting allows you to load your parametric script from an external file hosted publicly on the web.
-
-#### Format
-
-Provide a fully qualified URL to your script file:
-```
-https://example.com/scripts/my-configurator.txt
-```
-
-:::warning File Requirements
-The URL must point to:
-- A **publicly accessible** file (no authentication required)
-- Content in **text/plain** format
-- A script exported using "Export to Runner" from [bitbybit.dev](https://bitbybit.dev) editors
+:::info Common Setting
+This setting is shared between RUNNER and APPS blocks. See [Public Script URL in Common Settings](../getting-started/common-settings#public-script-url) for general information about URL requirements, hosting options, and CORS configuration.
 :::
 
-#### CORS Considerations
+The Public Script URL setting allows you to load your parametric script from an external file hosted publicly on the web.
 
-If hosting on a different domain than your Shopify store, ensure the server returns appropriate CORS headers:
-```
-Access-Control-Allow-Origin: *
-```
+#### RUNNER-Specific Behavior
 
-#### When to Use
+**Script Priority:**
+If an [Inline Script](#inline-script) is provided, it takes precedence and this URL will be ignored.
 
-Use Public Script URL when:
+**When to Use Public Script URL:**
 - You have a centralized script management system
 - The same script is used across multiple Shopify stores
 - You want to update scripts without modifying the metafield values in product page (keep in mind asset may be cached)
 - Your script is too large for comfortable inline embedding
 
-:::info Script Priority
-If an [Inline Script](#inline-script) is provided, it takes precedence and this URL will be ignored.
-:::
+**File Format:**
+The URL must point to a script exported using "Export to Runner" from [bitbybit.dev](https://bitbybit.dev) editors in text/plain format.
 
-#### Hosting Options
-
-You can host your script file on:
-- **Shopify CDN** - Upload as a theme asset
-- **GitHub Pages** - Use raw file URLs
+**Recommended Hosting:**
+- **Shopify CDN** - Upload as a theme asset for best reliability
+- **GitHub Pages** - Use raw file URLs for version control
 - **Cloud storage** - Google Cloud Storage, AWS S3, etc.
-- **Your own server** - Any web server with CORS enabled
+
+:::tip
+For most use cases, [Inline Script](#inline-script) is recommended as it's faster (no external HTTP request) and more reliable (no dependency on external hosting).
+:::
 
 ---
 

docs/learn/3d-bits/tutorials/getting-started/common-settings.md

@@ -111,8 +111,9 @@ These settings are shared by VIEWER, RUNNER, and APPS blocks:
 
 ### Runner and Apps Blocks Only
 
-This setting is specific to RUNNER and APPS blocks:
+These settings are specific to RUNNER and APPS blocks:
 
+- [Public Script URL](#public-script-url)
 - [Disable Inputs When Computing](#disable-inputs-when-computing)
 
 ## Setting Details
@@ -363,6 +364,58 @@ If you're using Scene JSON Configuration with skybox or advanced backgrounds, th
 
 ---
 
+### Public Script URL
+
+**Available in:** RUNNER, APPS  
+**Default:** Empty
+
+Controls which script or application the block loads from an external source. This setting enables different workflows depending on the block type.
+
+**For RUNNER Block:**
+Loads parametric scripts created in bitbybit.dev editors (Blockly, Rete, or Monaco). When empty, uses [Inline Script](../bitbybit-runner/settings#inline-script) instead.
+
+**For APPS Block:**
+Controls the three-mode development workflow (Local Development, Preview, Production). When empty, defaults to `https://localhost:4242` for local development.
+
+**Format:**
+
+Provide a fully qualified URL to your file:
+```
+https://example.com/scripts/my-file.txt
+https://localhost:4242/assets/index-stable.js
+https://cdn.shopify.com/s/files/1/xxx/index-hash.js
+```
+
+**File Requirements:**
+- **Publicly accessible** (no authentication required)
+- **CORS-enabled** if hosted on different domain
+- **RUNNER**: text/plain format with exported script from bitbybit.dev
+- **APPS**: ES6 module JavaScript file compiled with Vite
+
+**Hosting Options:**
+- **Shopify CDN** - Upload via Content → Files (recommended for production)
+- **Local Development** - localhost:4242 (APPS only)
+- **Cloud Storage** - AWS S3, Google Cloud Storage, etc.
+- **CDN Services** - Cloudflare, jsDelivr
+- **Your Own Server** - Any HTTPS server with CORS headers
+
+**CORS Requirements:**
+
+If hosting on a different domain, ensure proper CORS headers:
+```
+Access-Control-Allow-Origin: *
+Access-Control-Allow-Methods: GET, OPTIONS
+Access-Control-Allow-Headers: Content-Type
+```
+
+**Block-Specific Usage:**
+
+For detailed usage instructions specific to each block, see:
+- **RUNNER**: [Public Script URL setting](../bitbybit-runner/settings#public-script-url) - Script loading and priority
+- **APPS**: [Public Script URL setting](../bitbybit-apps/settings#public-script-url) - Development modes and workflow
+
+---
+
 ### Show Fullscreen Button
 
 **Available in:** VIEWER, RUNNER, PREVIEW, APPS