Files
webstudio/docs
Oleg Isonen 8a46350c9a fix: Compile MDX Content Blocks in hosted builds (#6455)
Hosted MDX pages can publish successfully and then fail to render
because the publish runner skips their source files. Restore source
downloads and compilation for MDX Content Blocks, including dynamic
article queries and template dependencies.

Reuse the existing publication planner and local content compiler.
Markdown-only pages keep their bodies on demand; hosted MDX pages
download article sources and pay the necessary compilation cost in the
runner, not the publish API. Reject missing content databases and MDX
materialization errors instead of deploying an incomplete page.

Ref #6450
Ref #6454

## Checklist

- [x] Reproduce missing MDX content using the affected deployed build.
- [x] Restore hosted MDX compilation without duplicating the
static-export compiler.
- [x] Add a sync → compile → generated query → React server-render
regression with a metadata-only API bundle and a frontmatter-bound
Content Block.
- [x] Verify new regression checks fail without the required behavior
and pass with it.
- [x] Reject missing MDX sources and content databases; preserve remote
article bodies when no MDX Content Blocks need compilation.
- [x] Review documentation impact and update the Content Engine
publishing explanation.
- [x] Run CLI tests, typecheck, lint, formatting, and package-boundary
checks.
- [x] Run the full fixture link/sync/build pipeline; no generated
changes.
- [x] Rebuild the affected project locally and exercise its generated
production request handler: HTTP 200 with the article title and body.
Asset requests were served from synced local files.

The live project was not modified or republished. Its existing
title/description bindings still use an array access for a single-result
query; that separate project-data issue is not changed here. Agent
evaluations were not run. Affected sites need republishing after the
updated CLI artifact is deployed.
2026-09-28 18:42:17 +02:00
..

description
description
New to Webstudio?

👋 Welcome

Our getting started guide will help you navigate through building your first Webstudio website. It covers the essentials of creating web designs and integrating third-party tools. You'll learn how to utilize Webstudio's unique features like Design tokens and Components, and how to contribute to the project.

Get started


{% content-ref url="basics/building-your-first-site.md" %} building-your-first-site.md {% endcontent-ref %}

{% content-ref url="university/foundations/" %} foundations {% endcontent-ref %}

{% content-ref url="university/core-components/" %} core-components {% endcontent-ref %}

{% content-ref url="university/cli.md" %} cli.md {% endcontent-ref %}

{% content-ref url="university/inception.md" %} inception.md {% endcontent-ref %}

{% content-ref url="university/radix/" %} radix {% endcontent-ref %}

{% content-ref url="university/marketplace.md" %} marketplace.md {% endcontent-ref %}

{% content-ref url="university/self-hosting/" %} self-hosting {% endcontent-ref %}

{% content-ref url="university/how-tos/" %} how-tos {% endcontent-ref %}

{% content-ref url="university/integrations/" %} integrations {% endcontent-ref %}

{% content-ref url="university/craft.md" %} craft.md {% endcontent-ref %}

{% content-ref url="basics/FAQ.md" %} FAQ.md {% endcontent-ref %}

Looking to contribute to Webstudio?

{% content-ref url="contributing/contributions.md" %} contributions.md {% endcontent-ref %}

{% content-ref url="contributing/marketplace.md" %} marketplace.md {% endcontent-ref %}