Skip to content

feat(website): deploy Rspress docs with Zephyr#4855

Merged
Nsttt merged 13 commits into
mainfrom
codex/add-zephyr-rspress-plugin
Jul 8, 2026
Merged

feat(website): deploy Rspress docs with Zephyr#4855
Nsttt merged 13 commits into
mainfrom
codex/add-zephyr-rspress-plugin

Conversation

@Nsttt

@Nsttt Nsttt commented Jun 30, 2026

Copy link
Copy Markdown
Member

Description

Moves the Rspress website deployment path from Netlify to Zephyr.

  • adds zephyr-rspress-plugin to apps/website-new
  • registers withZephyr() after the existing Module Federation Rspress plugin
  • adds a dedicated Website Zephyr Deploy GitHub Actions workflow using ZE_SECRET_TOKEN
  • runs pnpm run build:website on PR events before ZephyrCloudIO/zephyr-preview-environment-action@v0.1.1, so the action can read the Zephyr deploy result and comment the PR preview URL
  • passes ZE_SECRET_TOKEN and SITE_ORIGIN through Turbo for website-new#build
  • removes Netlify deployment config files
  • removes Netlify preview URL handling from rspress.config.ts
  • updates pnpm-lock.yaml for the new dependency tree

Related Issue

Direct maintainer request; no issue provided.

Types of changes

  • Docs change / refactoring / dependency upgrade
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)

Checklist

  • I have added tests to cover my changes.
  • All new and existing tests passed.
  • I have updated the documentation.

Validation:

  • docs-list completed; existing docs front matter is missing summary keys.
  • pnpm exec prettier --check apps/website-new/package.json apps/website-new/rspress.config.ts pnpm-lock.yaml passed.
  • pnpm exec prettier --check .github/workflows/website-zephyr.yml apps/website-new/rspress.config.ts turbo.json passed.
  • pnpm exec prettier --check .github/workflows/website-zephyr.yml turbo.json passed after PR-build ordering changes.
  • git diff --check passed.
  • pnpm run ci:local --only=actionlint ran; repo-local runner skips actionlint as GitHub-only.
  • committer pre-commit formatting/lint hooks completed for all commits; Turbo had no lint task for website-new.
  • pnpm --filter website-new run build reached Rspress build output, then failed in Zephyr upload with ZE10019 / 403 because the local user is not allowed to update website-new.core.module-federation.

Skipped / not complete:

  • Full website build/deploy is not green locally because Zephyr upload requires a valid ZE_SECRET_TOKEN/account permission for website-new.core.module-federation.
  • No tests added; this wires an Rspress build/deploy plugin and the CI build path is the relevant regression check.
  • Netlify-only redirects/headers were removed with the Netlify config; Zephyr plugin options do not expose an equivalent TOML-style redirect/header config in this package version.
  • actionlint is validated by GitHub Actions in this repo; the local runner intentionally skips it.

@netlify

netlify Bot commented Jun 30, 2026

Copy link
Copy Markdown

Deploy Preview for module-federation-docs failed. Why did it fail? →

Name Link
🔨 Latest commit 46f87a1
🔍 Latest deploy log https://app.netlify.com/projects/module-federation-docs/deploys/6a4dcce5c64def0008f5065c

@changeset-bot

changeset-bot Bot commented Jun 30, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 46f87a1

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@pkg-pr-new

pkg-pr-new Bot commented Jun 30, 2026

Copy link
Copy Markdown

Open in StackBlitz

@module-federation/devtools

pnpm add https://pkg.pr.new/@module-federation/devtools@46f87a1

@module-federation/cli

pnpm add https://pkg.pr.new/@module-federation/cli@46f87a1

create-module-federation

pnpm add https://pkg.pr.new/create-module-federation@46f87a1

@module-federation/dts-plugin

pnpm add https://pkg.pr.new/@module-federation/dts-plugin@46f87a1

@module-federation/enhanced

pnpm add https://pkg.pr.new/@module-federation/enhanced@46f87a1

@module-federation/error-codes

pnpm add https://pkg.pr.new/@module-federation/error-codes@46f87a1

@module-federation/esbuild

pnpm add https://pkg.pr.new/@module-federation/esbuild@46f87a1

@module-federation/managers

pnpm add https://pkg.pr.new/@module-federation/managers@46f87a1

@module-federation/manifest

pnpm add https://pkg.pr.new/@module-federation/manifest@46f87a1

@module-federation/metro

pnpm add https://pkg.pr.new/@module-federation/metro@46f87a1

@module-federation/metro-plugin-rnc-cli

pnpm add https://pkg.pr.new/@module-federation/metro-plugin-rnc-cli@46f87a1

@module-federation/metro-plugin-rnef

pnpm add https://pkg.pr.new/@module-federation/metro-plugin-rnef@46f87a1

@module-federation/metro-plugin-rock

pnpm add https://pkg.pr.new/@module-federation/metro-plugin-rock@46f87a1

@module-federation/modern-js

pnpm add https://pkg.pr.new/@module-federation/modern-js@46f87a1

@module-federation/modern-js-v3

pnpm add https://pkg.pr.new/@module-federation/modern-js-v3@46f87a1

@module-federation/native-federation-tests

pnpm add https://pkg.pr.new/@module-federation/native-federation-tests@46f87a1

@module-federation/native-federation-typescript

pnpm add https://pkg.pr.new/@module-federation/native-federation-typescript@46f87a1

@module-federation/nextjs-mf

pnpm add https://pkg.pr.new/@module-federation/nextjs-mf@46f87a1

@module-federation/node

pnpm add https://pkg.pr.new/@module-federation/node@46f87a1

@module-federation/observability-plugin

pnpm add https://pkg.pr.new/@module-federation/observability-plugin@46f87a1

@module-federation/playground

pnpm add https://pkg.pr.new/@module-federation/playground@46f87a1

@module-federation/retry-plugin

pnpm add https://pkg.pr.new/@module-federation/retry-plugin@46f87a1

@module-federation/rsbuild-plugin

pnpm add https://pkg.pr.new/@module-federation/rsbuild-plugin@46f87a1

@module-federation/rspack

pnpm add https://pkg.pr.new/@module-federation/rspack@46f87a1

@module-federation/rspress-plugin

pnpm add https://pkg.pr.new/@module-federation/rspress-plugin@46f87a1

@module-federation/runtime

pnpm add https://pkg.pr.new/@module-federation/runtime@46f87a1

@module-federation/runtime-core

pnpm add https://pkg.pr.new/@module-federation/runtime-core@46f87a1

@module-federation/runtime-tools

pnpm add https://pkg.pr.new/@module-federation/runtime-tools@46f87a1

@module-federation/sdk

pnpm add https://pkg.pr.new/@module-federation/sdk@46f87a1

@module-federation/storybook-addon

pnpm add https://pkg.pr.new/@module-federation/storybook-addon@46f87a1

@module-federation/third-party-dts-extractor

pnpm add https://pkg.pr.new/@module-federation/third-party-dts-extractor@46f87a1

@module-federation/treeshake-frontend

pnpm add https://pkg.pr.new/@module-federation/treeshake-frontend@46f87a1

@module-federation/treeshake-server

pnpm add https://pkg.pr.new/@module-federation/treeshake-server@46f87a1

@module-federation/typescript

pnpm add https://pkg.pr.new/@module-federation/typescript@46f87a1

@module-federation/utilities

pnpm add https://pkg.pr.new/@module-federation/utilities@46f87a1

@module-federation/webpack-bundler-runtime

pnpm add https://pkg.pr.new/@module-federation/webpack-bundler-runtime@46f87a1

@module-federation/bridge-react

pnpm add https://pkg.pr.new/@module-federation/bridge-react@46f87a1

@module-federation/bridge-react-webpack-plugin

pnpm add https://pkg.pr.new/@module-federation/bridge-react-webpack-plugin@46f87a1

@module-federation/bridge-shared

pnpm add https://pkg.pr.new/@module-federation/bridge-shared@46f87a1

@module-federation/bridge-vue3

pnpm add https://pkg.pr.new/@module-federation/bridge-vue3@46f87a1

@module-federation/inject-external-runtime-core-plugin

pnpm add https://pkg.pr.new/@module-federation/inject-external-runtime-core-plugin@46f87a1

commit: 46f87a1

@github-actions

github-actions Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Bundle Size Report

2 package(s) changed, 40 unchanged.

Package dist + ESM entry

Package Total dist (raw) Delta ESM gzip Delta
@module-federation/inject-external-runtime-core-plugin 5.2 kB +26 B (+0.5%) 520 B no change
@module-federation/runtime-tools 7.8 kB +65 B (+0.8%) 142 B no change

Bundle targets

Package Web bundle (gzip) Delta Node bundle (gzip) Delta
@module-federation/inject-external-runtime-core-plugin n/a n/a n/a n/a
@module-federation/runtime-tools n/a n/a n/a n/a

Consumer scenarios

Scenario Web output (gzip) Delta Node output (gzip) Delta Gap (node-web) Delta
Enhanced remoteEntry 21.4 kB -19 B (-0.1%) 23.0 kB -23 B (-0.1%) +1.6 kB -4 B

Total dist (raw): 35.69 MB (+91 B (+0.0%))
Total ESM gzip: 122.9 kB (no change)
Total web bundle (gzip): 0 B (no change)
Total node bundle (gzip): 0 B (no change)
Tracked ./bundler entry gzip: 556 B (no change)
Tracked ./bundler web bundle (gzip): 0 B (no change)
Tracked ./bundler node bundle (gzip): 0 B (no change)

Bundle sizes are generated with rslib (Rspack). Package-root metrics preserve the historical report. Tracked subpath exports such as ./bundler are measured separately so ENV_TARGET-driven tree-shaking is visible. Bare imports are externalized to keep package-level sizes consistent, and assets are emitted as resources.

Bundle errors

  • @module-federation/bridge-react: web: build is not a function; node: build is not a function
  • @module-federation/bridge-react-webpack-plugin: web: build is not a function; node: build is not a function
  • @module-federation/bridge-shared: web: build is not a function; node: build is not a function
  • @module-federation/bridge-vue3: web: build is not a function; node: build is not a function
  • @module-federation/cli: web: build is not a function; node: build is not a function
  • @module-federation/core: web: build is not a function; node: build is not a function
  • @module-federation/devtools: web: build is not a function; node: build is not a function
  • @module-federation/dts-plugin: web: build is not a function; node: build is not a function
  • @module-federation/enhanced: web: build is not a function; node: build is not a function
  • @module-federation/error-codes: web: build is not a function; node: build is not a function
  • @module-federation/esbuild: web: build is not a function; node: build is not a function
  • @module-federation/inject-external-runtime-core-plugin: web: build is not a function; node: build is not a function
  • @module-federation/managers: web: build is not a function; node: build is not a function
  • @module-federation/manifest: web: build is not a function; node: build is not a function
  • @module-federation/metro: web: build is not a function; node: build is not a function
  • @module-federation/metro-plugin-rnc-cli: web: build is not a function; node: build is not a function
  • @module-federation/metro-plugin-rnef: web: build is not a function; node: build is not a function
  • @module-federation/metro-plugin-rock: web: build is not a function; node: build is not a function
  • @module-federation/modern-js: web: build is not a function; node: build is not a function
  • @module-federation/modern-js-v3: web: build is not a function; node: build is not a function
  • @module-federation/native-federation-tests: web: build is not a function; node: build is not a function
  • @module-federation/native-federation-typescript: web: build is not a function; node: build is not a function
  • @module-federation/nextjs-mf: web: build is not a function; node: build is not a function
  • @module-federation/node: web: build is not a function; node: build is not a function
  • @module-federation/observability-plugin: web: build is not a function; node: build is not a function
  • @module-federation/playground: web: build is not a function; node: build is not a function
  • @module-federation/retry-plugin: web: build is not a function; node: build is not a function
  • @module-federation/rsbuild-plugin: web: build is not a function; node: build is not a function
  • @module-federation/rspack: web: build is not a function; node: build is not a function
  • @module-federation/rspress-plugin: web: build is not a function; node: build is not a function
  • @module-federation/runtime: web: build is not a function; node: build is not a function
  • @module-federation/runtime ./bundler: web: build is not a function; node: build is not a function
  • @module-federation/runtime-core: web: build is not a function; node: build is not a function
  • @module-federation/runtime-tools: web: build is not a function; node: build is not a function
  • @module-federation/runtime-tools ./bundler: web: build is not a function; node: build is not a function
  • @module-federation/sdk: web: build is not a function; node: build is not a function
  • @module-federation/storybook-addon: web: build is not a function; node: build is not a function
  • @module-federation/third-party-dts-extractor: web: build is not a function; node: build is not a function
  • @module-federation/treeshake-server: web: build is not a function; node: build is not a function
  • @module-federation/utilities: web: build is not a function; node: build is not a function
  • @module-federation/webpack-bundler-runtime: web: build is not a function; node: build is not a function
  • @module-federation/webpack-bundler-runtime ./bundler: web: build is not a function; node: build is not a function
  • create-module-federation: web: build is not a function; node: build is not a function

@Nsttt Nsttt changed the title feat(website): add Zephyr Rspress plugin feat(website): deploy Rspress docs with Zephyr Jun 30, 2026
@Nsttt Nsttt self-assigned this Jun 30, 2026
@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

🚀 Preview Environment Ready!

Name Status URL
website-new ✅ Active https://nestor-lopez-27719-website-new-core-module-federa-e17d995... ↗

Details:

  • Latest Commit: 46f87a1
  • Updated at: 7/8/2026, 4:10:53 AM

@Nsttt Nsttt marked this pull request as ready for review July 1, 2026 06:30

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 139995586c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +8 to +9
- 'apps/website-new/**'
- 'packages/rspress-plugin/**'

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Include website dependencies in deploy path filters

This workflow only wakes up for apps/website-new and packages/rspress-plugin, but website-new also directly consumes workspace packages such as @module-federation/runtime and @module-federation/error-codes. A PR or main push that changes packages/runtime/** or packages/error-codes/** without touching the root package files will not run this workflow, so the Zephyr preview/production docs can keep serving bundles built against the old workspace code. Please add the website's other workspace dependency paths, or avoid the narrow path filter.

Useful? React with 👍 / 👎.

process.env.CONTEXT === 'deploy-preview'
? process.env.DEPLOY_PRIME_URL
: 'https://module-federation.io/',
assetPrefix: `${siteOrigin}/`,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the preview origin for generated assets

On pull_request builds this now resolves to https://module-federation.io/ because the workflow sets SITE_ORIGIN globally and the old DEPLOY_PRIME_URL preview branch was removed. Since this value is used as Rsbuild's assetPrefix, Zephyr preview HTML will request its JS/CSS and other Rspress assets from the production site instead of the preview deployment, making preview URLs show stale production assets for docs/theme/runtime changes. Keep the asset prefix relative or derive it from the Zephyr preview URL for PR builds.

Useful? React with 👍 / 👎.

@2heal1

2heal1 commented Jul 6, 2026

Copy link
Copy Markdown
Member

@ScriptedAlchemy please help check this ~

@ScriptedAlchemy

Copy link
Copy Markdown
Member

@2heal1 will do!

@Nsttt

Nsttt commented Jul 6, 2026

Copy link
Copy Markdown
Member Author

@2heal1 will do!

We can sync to have it deployed to your account and everything anytime

@Nsttt Nsttt force-pushed the codex/add-zephyr-rspress-plugin branch from 9fe757a to 46f87a1 Compare July 8, 2026 04:06
@Nsttt Nsttt merged commit 8c684ef into main Jul 8, 2026
22 of 26 checks passed
@Nsttt Nsttt deleted the codex/add-zephyr-rspress-plugin branch July 8, 2026 04:15
@2heal1 2heal1 mentioned this pull request Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants