moritzhartmeier · Sep 22, 2026 · Aug 19, 2026 · Aug 20, 2026 · Aug 20, 2026 · Aug 24, 2026
diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
@@ -45,6 +45,18 @@ jobs:
       - name: Install dependencies
         run: yarn install --frozen-lockfile
 
+      # Whole-corpus check: the docs gate is a ratchet on changed files, so it
+      # cannot see a pre-existing violation nobody touched. This is what makes a
+      # framework value outside the enum - in docs OR in the code maps that read
+      # it - break the build instead of silently mis-resolving.
+      - name: Verify framework identifiers
+        run: yarn verify:frameworks
+
+      # Pins the membership of every derived framework map. The refactor risk
+      # here is not a crash, it is a map quietly gaining or losing an entry.
+      - name: Test framework registry
+        run: yarn test:frameworks
+
       - name: Build documentation
         run: yarn build
 

diff --git a/.github/workflows/docs-gate.yml b/.github/workflows/docs-gate.yml
@@ -71,10 +71,12 @@ jobs:
 
       - name: Install Vale (pinned)
         run: |
-          # The version the rules in styles/Scandit/ were measured against -
-          # both of them encode behaviour that is version-specific, down to
-          # which regex constructs the token engine honours, and a local pass
-          # on one version proves nothing about another.
+          # The version the rules in styles/Scandit/ and the frontmatter cap in
+          # scripts/docs-gate were both measured against. Both encode behaviour
+          # that is version-specific, down to which regex constructs the token
+          # engine honours, and the cap additionally rests on Vale attributing a
+          # `description` alert to its true file line. A local pass on one
+          # version proves nothing about another.
           #
           # CI only. scripts/setup-vale.cjs does not install Vale at all - it
           # checks for it, prints winget/brew guidance if it is missing, and
@@ -97,6 +99,23 @@ jobs:
       - name: Sync Vale styles
         run: yarn docs:gate:setup
 
+      # The gate scripts' own readers and, through a fixture tree, the whole of
+      # verify-frameworks. Each defect these rows pin made a gate print OK while
+      # a check went unperformed, which no amount of green output would show.
+      #
+      # Here rather than in build-docs.yml because the prose rows need the Vale
+      # BINARY on PATH - without it the gate prints "Vale not installed", skips
+      # the prose checks, and the rows would pass vacuously, so the suite asserts
+      # its presence and goes red instead. This job is the one that installs it.
+      # It needs the binary ONLY: the fixture writes its own .vale.ini with no
+      # Packages line, so it runs before or after `vale sync` indifferently and
+      # never touches the network.
+      #
+      # Before the real gate deliberately: if the gate's own readers are broken,
+      # that is worth knowing before reading anything the gate reports.
+      - name: Test docs-gate readers
+        run: yarn test:docs-gate
+
       - name: Run docs quality gate
         # GITHUB_BASE_REF makes the gate ratchet against the PR's target branch.
         run: yarn docs:gate
diff --git a/.gitignore b/.gitignore
@@ -32,3 +32,7 @@ validation/cache/
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+
+# scripts/test-docs-gate.cjs scratch dirs (pid-suffixed; removed in a finally,
+# so these only appear after a hard kill)
+scripts/.test-docs-gate-tmp-*
diff --git a/docs-schema.yml b/docs-schema.yml
@@ -35,14 +35,39 @@ properties:
            matrixscan-ar, matrixscan-pick, barcode-selection, barcode-generator,
            id-capture, id-bolt, label-capture, parser, express, core, platform]
 
+  # Canonical framework slugs. These are the SSOT for every framework identifier
+  # under docs/ and in code: they are exactly the `/sdks/<slug>/` URL segments
+  # (with `hosted` for the /hosted/ tree), and src/constants/frameworks.ts must
+  # cover this same set - `yarn verify:frameworks` fails the build if the two
+  # drift. That file is the registry the gate reads;
+  # src/components/utils/frameworks.ts is derived from it and is never read by the
+  # gate, so adding a slug there alone satisfies nothing.
+  #
+  # NOT versioned_docs/. Those snapshots still carry the pre-rename vocabulary
+  # (`react`, `netIos`, `xamarinForms`, `express`) and are exempt on purpose;
+  # see the scope note in scripts/verify-frameworks.cjs. Saying "every identifier
+  # in the repo" here was wrong: ~470 declarations in the snapshots are outside
+  # this enum and nothing checks them.
+  #
+  # `kmp` (Kotlin Multiplatform) is documented only in the in-development docs
+  # version; that is tracked by UNRELEASED_FRAMEWORK_SLUGS in
+  # src/constants/unreleasedFrameworks.ts, not by leaving it out of this enum.
+  #
+  # Singular `framework` and plural `frameworks` share the set deliberately: a
+  # page states one platform or several, never two different vocabularies.
+  framework:
+    type: string
+    enum: [ios, android, web, react-native, flutter, cordova, capacitor, kmp,
+           titanium, linux, net-ios, net-android, hosted]
+
   frameworks:
     type: array
     minItems: 1
     uniqueItems: true
     items:
       type: string
-      enum: [ios, android, web, react-native, flutter, cordova, capacitor, titanium,
-             linux, net-ios, net-android, hosted]
+      enum: [ios, android, web, react-native, flutter, cordova, capacitor, kmp,
+             titanium, linux, net-ios, net-android, hosted]
 
   version_status:
     type: string

diff --git a/docs/hosted/express/configuration/custom-data-transfer/input-configuration.md b/docs/hosted/express/configuration/custom-data-transfer/input-configuration.md
@@ -1,6 +1,7 @@
 ---
 description: "Define the input fields Custom Data Transfer collects during scanning in Scandit Express, and set each field's type and format."
-framework: express
+framework: hosted
+product: express
 sidebar_label: Input Configuration
 keywords:
   - express

diff --git a/docs/hosted/express/configuration/custom-data-transfer/output-configuration.md b/docs/hosted/express/configuration/custom-data-transfer/output-configuration.md
@@ -1,6 +1,7 @@
 ---
 description: "Configure how Custom Data Transfer structures, transforms, and exports scanned data to external systems in Scandit Express."
-framework: express
+framework: hosted
+product: express
 sidebar_label: Output Configuration
 keywords:
   - express

diff --git a/docs/hosted/express/configuration/custom-data-transfer/overview.md b/docs/hosted/express/configuration/custom-data-transfer/overview.md
@@ -1,6 +1,7 @@
 ---
 description: "Import and export data in Scandit Express using a configurable CSV file or Google Sheet, aligning formats with your system without coding."
-framework: express
+framework: hosted
+product: express
 sidebar_label: Overview
 keywords:
   - express

diff --git a/docs/hosted/express/configuration/device-pairing/bluetooth-pairing.md b/docs/hosted/express/configuration/device-pairing/bluetooth-pairing.md
@@ -1,6 +1,7 @@
 ---
 description: "Set up Bluetooth device pairing in Scandit Express to send scanned data from one device to another."
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/configuration/device-pairing/device-pairing.md b/docs/hosted/express/configuration/device-pairing/device-pairing.md
@@ -1,6 +1,7 @@
 ---
 description: "Use Device Pairing in Scandit Express to transfer scanned barcode data in real time from a sender device to the receiver running your app."
-framework: express
+framework: hosted
+product: express
 sidebar_label: Overview
 keywords:
   - express

diff --git a/docs/hosted/express/configuration/device-pairing/online-connection.md b/docs/hosted/express/configuration/device-pairing/online-connection.md
@@ -1,6 +1,7 @@
 ---
 description: "Set up online device pairing in Scandit Express to send scanned data to a web application."
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/configuration/express-find.md b/docs/hosted/express/configuration/express-find.md
@@ -1,7 +1,8 @@
 ---
 description: "Find Items in Scandit Express, powered by MatrixScan Find, speeds up picking by scanning many items and highlighting the right ones in AR."
 
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/configuration/index.md b/docs/hosted/express/configuration/index.md
@@ -2,7 +2,8 @@
 description: "Overview of the configuration options available in Scandit Express and how to set them up."
 
 toc_max_heading_level: 4
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/configuration/inventory-count.md b/docs/hosted/express/configuration/inventory-count.md
@@ -1,6 +1,7 @@
 ---
 description: "Use the Inventory Count mode in Scandit Express for fast, accurate stock counting."
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/configuration/scan-labels.md b/docs/hosted/express/configuration/scan-labels.md
@@ -1,6 +1,7 @@
 ---
 description: "Scan Labels in Scandit Express, powered by Smart Label Capture, reads multiple barcodes and printed text on a label in one scan."
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/getting-started/installation.md b/docs/hosted/express/getting-started/installation.md
@@ -3,7 +3,8 @@ description: "Install Scandit Express on iOS or Android and activate it to add b
 sidebar_label: 'Installation'
 displayed_sidebar: expressSidebar
 sidebar_position: 1
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/getting-started/rollout.md b/docs/hosted/express/getting-started/rollout.md
@@ -4,7 +4,8 @@ description: "Roll out Scandit Express to production with a mobile device manage
 sidebar_label: 'Rollout via MDM/EMM'
 displayed_sidebar: expressSidebar
 sidebar_position: 2
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/express/overview.md b/docs/hosted/express/overview.md
@@ -5,7 +5,8 @@ sidebar_position: 1
 sidebar_label: 'Overview'
 title: 'Scandit Express'
 displayed_sidebar: expressSidebar
-framework: express
+framework: hosted
+product: express
 keywords:
   - express
 ---

diff --git a/docs/hosted/id-bolt/advanced.md b/docs/hosted/id-bolt/advanced.md
@@ -5,7 +5,8 @@ sidebar_label: "Advanced Options"
 title: "Advanced Options"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - advanced

diff --git a/docs/hosted/id-bolt/api-overview.md b/docs/hosted/id-bolt/api-overview.md
@@ -5,7 +5,8 @@ sidebar_label: "API Overview"
 title: "API Overview"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
 ---

diff --git a/docs/hosted/id-bolt/callbacks.md b/docs/hosted/id-bolt/callbacks.md
@@ -5,7 +5,8 @@ sidebar_label: "Callbacks"
 title: "Callbacks"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - callbacks

diff --git a/docs/hosted/id-bolt/data-handling.md b/docs/hosted/id-bolt/data-handling.md
@@ -5,7 +5,8 @@ sidebar_label: "Data Handling"
 title: "Data Handling"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - data handling

diff --git a/docs/hosted/id-bolt/document-selection.md b/docs/hosted/id-bolt/document-selection.md
@@ -5,7 +5,8 @@ sidebar_label: "Document Selection"
 title: "Document Selection"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - document selection

diff --git a/docs/hosted/id-bolt/getting-started.md b/docs/hosted/id-bolt/getting-started.md
@@ -5,7 +5,8 @@ sidebar_label: "Getting Started"
 title: "Getting Started"
 hide_title: false
 displayed_sidebar: boltSidebar
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
 ---

diff --git a/docs/hosted/id-bolt/overview.md b/docs/hosted/id-bolt/overview.md
@@ -5,7 +5,8 @@ sidebar_position: 1
 sidebar_label: "Overview"
 title: "ID Bolt"
 displayed_sidebar: boltSidebar
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
 ---

diff --git a/docs/hosted/id-bolt/release-notes.md b/docs/hosted/id-bolt/release-notes.md
@@ -2,7 +2,8 @@
 description: "Release notes for ID Bolt: new features, changes, and fixes by date."
 toc_max_heading_level: 3
 displayed_sidebar: boltSidebar
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
 hide_title: true

diff --git a/docs/hosted/id-bolt/text-overrides.md b/docs/hosted/id-bolt/text-overrides.md
@@ -5,7 +5,8 @@ sidebar_label: "Text Overrides"
 title: "Text Overrides"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - customization

diff --git a/docs/hosted/id-bolt/theming.md b/docs/hosted/id-bolt/theming.md
@@ -5,7 +5,8 @@ sidebar_label: "Theming"
 title: "Theming"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - theming

diff --git a/docs/hosted/id-bolt/validators.md b/docs/hosted/id-bolt/validators.md
@@ -5,7 +5,8 @@ sidebar_label: "Validators"
 title: "Validators"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - validators

diff --git a/docs/hosted/id-bolt/workflow.md b/docs/hosted/id-bolt/workflow.md
@@ -5,7 +5,8 @@ sidebar_label: "Workflow Options"
 title: "Workflow & Scanner Options"
 displayed_sidebar: boltSidebar
 toc_max_heading_level: 4
-framework: bolt
+framework: hosted
+product: id-bolt
 keywords:
   - bolt
   - workflow

diff --git a/docs/sdks/net/android/add-sdk.md b/docs/sdks/net/android/add-sdk.md
@@ -3,7 +3,7 @@ description: "Add the Scandit Data Capture SDK to your .NET Android project: dep
 sidebar_position: 1
 toc_max_heading_level: 4
 pagination_next: null
-framework: netAndroid
+framework: net-android
 keywords:
   - netAndroid
 ---

diff --git a/docs/sdks/net/android/ai-powered-barcode-scanning.md b/docs/sdks/net/android/ai-powered-barcode-scanning.md
@@ -1,7 +1,7 @@
 ---
 description: "import AIPoweredBarcodeScanning from '../../../partials/_ai-powered-barcode-scanning.mdx';"
 toc_max_heading_level: 4
-framework: netAndroid
+framework: net-android
 keywords:
   - netAndroid
 ---

diff --git a/docs/sdks/net/android/barcode-capture/configure-barcode-symbologies.md b/docs/sdks/net/android/barcode-capture/configure-barcode-symbologies.md
@@ -2,7 +2,7 @@
 description: "Enable and configure barcode symbologies for Barcode Capture on .NET Android."
 sidebar_position: 3
 pagination_next: null
-framework: netAndroid
+framework: net-android
 keywords:
   - netAndroid
 ---

diff --git a/docs/sdks/net/android/barcode-capture/get-started.md b/docs/sdks/net/android/barcode-capture/get-started.md
@@ -2,7 +2,7 @@
 description: "Add Barcode Capture to your .NET Android app: configure the mode, set up the camera and view, and handle scanned barcodes."
 sidebar_position: 2
 pagination_prev: null
-framework: netAndroid
+framework: net-android
 keywords:
   - netAndroid
 ---

diff --git a/docs/sdks/net/android/barcode-selection/get-started.md b/docs/sdks/net/android/barcode-selection/get-started.md
@@ -2,7 +2,7 @@
 description: "Add Barcode Selection to your .NET Android app so users can tap or aim to select a single barcode among many."
 sidebar_position: 2
 pagination_next: null
-framework: netAndroid
+framework: net-android
 keywords:
   - netAndroid
 ---