@bleedingdev/modern-js-main-doc 3.8.2-ultramodern.9 → 3.8.3-ultramodern.2

package/docs/zh/guides/get-started/ultramodern.mdx

@@ -62,9 +62,9 @@ UltraModern.js 的增强能力是新 SuperApp 的默认产品面。框架方向
 旧版生成 workspace 迁移时，以已发布的包 cohort 作为事实来源：
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create@latest --help
-pnpm dlx @bleedingdev/modern-js-create@latest catalog --vertical --dry-run
-pnpm dlx @bleedingdev/modern-js-create@latest catalog --vertical
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@latest --help
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@latest catalog --vertical --dry-run
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@latest catalog --vertical
 mise install
 mise exec -- pnpm install
 mise exec -- pnpm check
@@ -81,8 +81,8 @@ server runtime 中。请求 `/` 时，框架会按语言协商在服务端返回
 先解析当前 cohort 版本，再运行同版本迁移命令：
 
 ```bash
-COHORT="$(npm view @bleedingdev/modern-js-create version)"
-pnpm dlx "@bleedingdev/modern-js-create@$COHORT" ultramodern \
+COHORT="$(npm view @bleedingdev/modern-js-ultramodern-create version)"
+pnpm dlx "@bleedingdev/modern-js-ultramodern-create@$COHORT" ultramodern \
   migrate-strict-effect --version "$COHORT"
 pnpm install
 pnpm check
@@ -114,8 +114,8 @@ postprocess、生成产物编辑或本地 redirect shim 来修复旧版本的 ro
 手写 package alias 或生成 metadata 之前，先在目标 workspace 运行框架迁移命令：
 
 ```bash
-COHORT="$(npm view @bleedingdev/modern-js-create version)"
-pnpm dlx "@bleedingdev/modern-js-create@$COHORT" ultramodern \
+COHORT="$(npm view @bleedingdev/modern-js-ultramodern-create version)"
+pnpm dlx "@bleedingdev/modern-js-ultramodern-create@$COHORT" ultramodern \
   migrate-strict-effect --version "$COHORT"
 pnpm api:check
 pnpm contract:check
@@ -128,8 +128,8 @@ pnpm overrides/trust policy 和 pnpm lockfile。剩余失败就是源码迁移
 `api/lambda`、`shared/effect` 和 `src/effect`。
 
 严格 Effect 生成 workspace 会通过 pnpm overrides 固定兼容版本组：
-`effect@4.0.0-beta.107`、`@effect/opentelemetry@4.0.0-beta.107` 和
-`@effect/vitest@4.0.0-beta.107`。不要添加与这些 overrides 冲突的 app 本地直接
+`effect@4.0.0-rc.112`、`@effect/opentelemetry@4.0.0-rc.112` 和
+`@effect/vitest@4.0.0-rc.112`。不要添加与这些 overrides 冲突的 app 本地直接
 Effect 版本。严格的 24 小时发布年龄门禁适用于实际安装的包；当前版本组不包含 Effect
 年龄豁免，仅用于 override 的 `@effect/vitest` 也不是已安装的审批目标。
 `trustPolicyExclude` 是独立策略，仅为 `effect` 和
@@ -140,12 +140,21 @@ provenance attestation 的迁移；它不属于 release-age 审批。
 
 | 范围 | 固定版本 |
 | --- | --- |
-| Effect runtime 与测试版本组 | `effect`、`@effect/opentelemetry`、`@effect/vitest`：`4.0.0-beta.107` |
-| Effect compiler | `@effect/tsgo@0.36.2` |
-| TanStack Router | `@tanstack/react-router@1.170.25`、`@tanstack/router-core@1.171.21`、`@tanstack/history@1.162.1` |
-| Module Federation | `bridge-react`、`manifest`、`modern-js-v3`、`rspack`：`2.8.2`；`@module-federation/node@2.7.49` |
-| React Router | `react-router@7.18.2` |
-| Node 与包管理工具 | Node `26.7.0`、`@types/node@^26.2.0`、pnpm `11.21.0` |
+| Effect runtime 与测试版本组 | `effect`、`@effect/opentelemetry`、`@effect/vitest`：`4.0.0-rc.112` |
+| Effect compiler | `@effect/tsgo@0.37.0` |
+| Oxc 与 Ultracite | `oxlint@1.80.0`、`oxfmt@0.65.0`、`ultracite@7.10.6` |
+| TanStack Router | `@tanstack/react-router@1.170.32`、`@tanstack/router-core@1.171.27`、`@tanstack/history@1.162.1` |
+| Module Federation | `bridge-react`、`manifest`、`modern-js-v3`、`rspack`：`2.9.0`；`@module-federation/node@2.7.50` |
+| Tailwind CSS | `tailwindcss@4.3.3` |
+| Node 与包管理工具 | Node `26.7.0`、`@types/node@^26.2.0`、pnpm `11.24.0` |
+
+生成的 workspace 默认使用 `@module-federation/bridge-react` 的
+router-free base entry（`bridge.enableBridgeRouter: false`），应用路由由
+TanStack Router 承担；某个 app 的 package.json 直接依赖中声明了
+`react-router`（或 `react-router-dom`），该 app 就会被标记为 React Router
+consumer：generator/migration 会为该 app 的 federation 配置生成
+`enableBridgeRouter: true`，workspace validator 也会接受这个值，UltraModern
+preset 会为该 app 自身的路由 alias `react-router` 的入口。
 
 渐进迁移意味着尚未迁移的旧 Modern.js app 可以保留现有 runtime，直到被转换为
 UltraModern。一个 surface 一旦生成为或迁移为 UltraModern HTTP API，就只能使用
@@ -212,6 +221,87 @@ migration 时不要再用 app 本地 postprocess。Cloudflare public output 默
 会按 app、构建目标和 Rspack environment 隔离，避免本地 `build`、`cloudflare:build`
 以及多 environment compiler 共享可变构建状态。
 
+## 配置公开预设
+
+在标准 Modern.js `defineConfig` 调用中使用
+`presetUltramodern(appConfig, presetOptions)`：
+
+```ts title="modern.config.ts"
+import { defineConfig, presetUltramodern } from '@modern-js/app-tools';
+
+export default defineConfig(
+  presetUltramodern(
+    {
+      output: {
+        precompress: false,
+      },
+      server: {
+        telemetry: {
+          failLoudStartup: true,
+        },
+      },
+    },
+    {
+      appId: 'catalog',
+      enableModuleFederationSSR: false,
+      enableTelemetryExporters: false,
+    },
+  ),
+);
+```
+
+第一个参数是普通的 `AppUserConfig`，用于应用自己拥有的配置，并在提供覆盖值时胜出。
+第二个参数控制预设本身。关闭预设能力时，使用它提供的类型化选项，例如
+`enableBffRequestId: false`、`enableTelemetry: false`、
+`enableTelemetryExporters: false` 和 `enableModuleFederationSSR: false`。
+
+组合过程遵循 Modern.js 配置合并规则：
+
+- 嵌套对象会递归合并。修改一个嵌套字段时，预设中的同级字段会保留。
+- 应用提供的标量和 `false` 会覆盖预设值。省略字段或将其保留为 `undefined` 时，
+  预设值会保留。
+- 数组和配置 hook 按预设优先的顺序组合。非函数数组项按深度相等去重，函数项则全部
+  保留。空数组或空对象不会清除预设已经提供的值。
+
+这里没有通用的 reset sentinel。预设拥有的行为应使用类型化预设选项控制，应用拥有的
+行为应使用普通应用配置覆盖。
+
+`createPresetUltramodernConfig(options)` 是用于检查或生成一份全新预设配置的高级 API。
+不要把它的结果展开进另一个配置对象。对象展开是浅层操作，替换 `server`、`output`
+或其他嵌套对象时，会无提示地丢弃预设中的同级字段。编写 `modern.config.ts` 时应使用
+`presetUltramodern(...)`。
+
+### 裸预设与生成 workspace 的策略
+
+预设和 workspace 生成器分别负责不同的配置：
+
+| 来源 | 身份配置 | 其他配置 |
+| --- | --- | --- |
+| 裸 `createPresetUltramodernConfig()` 的结果 | 使用 `appId: 'app'`，不设置 `deliveryUnit` | 使用预设默认值。Telemetry 保持启用，但只有设置具体端点后才会配置对应导出器。 |
+| 生成的应用 | 提供应用专属的 `appId` 和生成时写入的 `deliveryUnit` | 其他严格默认值继承自 `presetUltramodern(...)`。 |
+| 应用 | 通过第一个 `appConfig` 参数提供配置 | 按 Modern.js 的正常合并规则覆盖应用拥有的字段。 |
+
+应保留生成的 `appId` 和 `deliveryUnit` 选项。修改预设拥有的行为时，使用类型化选项，
+例如
+`enableTelemetryExporters: false`、`enableTelemetry: false`、
+`enableBffRequestId: false` 或 `enableModuleFederationSSR: false`。修改应用拥有的
+字段时，应像上面的示例一样，把覆盖值放在第一个参数中。
+
+Telemetry 导出端点默认不设置：
+
+- `MODERN_TELEMETRY_OTLP_ENDPOINT` 只启用 OTLP 导出器。
+- `MODERN_TELEMETRY_VICTORIA_ENDPOINT` 只启用 VictoriaMetrics 导出器。
+- 同时设置两个变量会启用两个导出器。两个变量都未设置时，telemetry 管线保持启用，
+  但不会配置导出器。
+
+类型化的 `otlpEndpoint` 和 `victoriaMetricsEndpoint` 预设选项也能提供同样的
+逐导出器行为，无需使用环境变量。
+
+```bash
+MODERN_TELEMETRY_OTLP_ENDPOINT=https://otel.example.com/v1/logs \
+  mise exec -- pnpm dev
+```
+
 ## 人类工作流
 
 公开的 BleedingDev create 包只有一个受支持的生成产品。默认命令会创建一个
@@ -220,7 +310,7 @@ SSR、TanStack Router、Tailwind CSS v4、i18n、Effect HttpApi BFF、Module Fed
 topology、生成质量 gate，以及 Cloudflare 部署基础：
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create myapp
+pnpm dlx @bleedingdev/modern-js-ultramodern-create myapp
 cd myapp
 mise install
 mise exec -- pnpm install
@@ -231,10 +321,10 @@ workspace 从 shell 和平台契约起步，不强制生成演示业务域。真
 再添加对应 MicroVertical：
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create transportation --vertical
-pnpm dlx @bleedingdev/modern-js-create food-delivery --vertical
-pnpm dlx @bleedingdev/modern-js-create payments --vertical
-pnpm dlx @bleedingdev/modern-js-create maps --vertical
+pnpm dlx @bleedingdev/modern-js-ultramodern-create transportation --vertical
+pnpm dlx @bleedingdev/modern-js-ultramodern-create food-delivery --vertical
+pnpm dlx @bleedingdev/modern-js-ultramodern-create payments --vertical
+pnpm dlx @bleedingdev/modern-js-ultramodern-create maps --vertical
 mise exec -- pnpm check
 ```
 
@@ -247,10 +337,10 @@ ownership 记录、shell Module Federation、开发 overlays、包依赖、生
 自动化脚本可以使用显式 MicroVertical 语法，不必依赖位置参数：
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create --vertical=transportation
-pnpm dlx @bleedingdev/modern-js-create --vertical-name transportation
-pnpm dlx @bleedingdev/modern-js-create transportation --vertical --dry-run
-pnpm dlx @bleedingdev/modern-js-create transportation --vertical \
+pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical=transportation
+pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical-name transportation
+pnpm dlx @bleedingdev/modern-js-ultramodern-create transportation --vertical --dry-run
+pnpm dlx @bleedingdev/modern-js-ultramodern-create transportation --vertical \
   --codesmith-overlay ./generators/vertical-overlay
 ```
 
@@ -268,7 +358,7 @@ import {
   addUltramodernVertical,
   generateUltramodernWorkspace,
   planUltramodernVertical,
-} from '@modern-js/create/ultramodern-workspace';
+} from '@modern-js/ultramodern-create/ultramodern-workspace';
 
 const workspace = generateUltramodernWorkspace({
   targetDir: '/tmp/my-workspace',
@@ -299,7 +389,7 @@ MicroVertical dry-run 返回相同结构，并额外包含 `dryRun`、`selectedP
 CodeSmith 消费方可以使用 adapter subpath：
 
 ```ts
-import ultramodernCodeSmith from '@modern-js/create/ultramodern-workspace/codesmith';
+import ultramodernCodeSmith from '@modern-js/ultramodern-create/ultramodern-workspace/codesmith';
 
 await ultramodernCodeSmith({
   config: {
@@ -377,18 +467,6 @@ Live Cloudflare 与 Zephyr 证明需要公开 Worker URL 和 Zephyr 凭据。没
 BleedingDev 包通过 GitHub Actions trusted publishing 发布。公开发布 workflow 不使用
 长期 npm token；不要从开发机器手动发布包。
 
-## 基线开关（可按需关闭）
-
-生成的 `presetUltramodern(...)` 脚手架会开启更严格的平台契约。以下环境变量会在生成的 `modern.config.ts` 中读取，可按应用或按环境关闭/覆盖：
-
-- `MODERN_BASELINE_ENABLE_MF_SSR`（默认：`true`）：开启应用级 MF SSR 基线契约（`server.ssr.mode: 'stream'` + `moduleFederationAppSSR`）。应用不使用 app-level MF SSR 或希望先走普通 SSR/CSR 路径时可关闭。
-- `MODERN_BASELINE_ENABLE_BFF_REQUEST_ID`（默认：`true`）：开启默认 BFF producer 身份契约（`bff.requestId`）。应用不需要跨项目 producer 隔离时可关闭。
-- `MODERN_BASELINE_ENABLE_TELEMETRY_EXPORTERS`（默认：`true`）：在基线配置中启用 telemetry 导出器。当前环境还没有 telemetry 后端时可关闭。
-- `MODERN_BASELINE_APP_ID`（默认：`basename(process.cwd())`）：覆盖基线 `bff.requestId` 身份。需要固定、可治理的统一 producer ID 命名时建议设置。
-- `MODERN_TELEMETRY_OTLP_ENDPOINT`（默认：`http://127.0.0.1:4318/v1/logs`）：OTLP 导出端点。接入其他 OTLP collector 地址时覆盖。
-- `MODERN_TELEMETRY_VICTORIA_ENDPOINT`（默认：`http://127.0.0.1:8428/api/v1/import/prometheus`）：VictoriaMetrics 导出端点。接入其他 VM 写入地址时覆盖。
-- `MODERN_TELEMETRY_FAIL_LOUD_STARTUP`（默认：`true`）：导出器健康检查失败时启动即失败（fail-loud）。本地/开发环境希望 telemetry 故障不阻断启动时可关闭。
-
 ## 相关文档
 
 - [BFF 运行时框架](/guides/advanced-features/bff/frameworks)

package/docs/zh/guides/troubleshooting/cli.mdx

@@ -35,5 +35,5 @@ pnpm run command --options
 ```
 
 :::tip
-Modern.js 要求 Node.js >= 20.19.5，而 pnpm v6 不支持 Node.js 20，因此请使用 pnpm v7 或更高版本。
+UltraModern.js 要求 Node.js >= 26.7.0 和 pnpm >= 11。请使用仓库锁定的 mise 工具链，以保持 CLI 与 Node.js 原生 TypeScript 运行时一致。
 :::

package/docs/zh/tutorials/examples/csr-auth.mdx

@@ -4,7 +4,7 @@ title: 路由鉴权
 
 # 路由鉴权
 
-Modern.js 默认提供的路由方式是基于 React Router 的约定式路由，具体可查看[路由方案](/guides/basic-features/routes/routes#路由方案)。
+UltraModern.js 默认使用基于 TanStack Router 的约定式路由，具体可查看[路由方案](/guides/basic-features/routes/routes#路由方案)。
 
 在一个 Web 应用中如果存在多个路由，我们可能需要对部分路由进行鉴权后才能访问。例如下面这个案例：
 
@@ -12,6 +12,7 @@ Modern.js 默认提供的路由方式是基于 React Router 的约定式路由
 - 访问 `/protected` 路由，需要鉴权，如果无，自动跳转到 `/login` 路由，登录成功后返回 `/protected`。
 
 import Sandpack from '@site/src/components/Sandpack';
+import { ultramodernSandpackFiles } from '@modern-js/ultramodern-sandpack-profile';
 import srcRoutesPageText from '../../../../src/sandbox/csr-auth/src/routes/page-tsx.txt';
 import srcRoutesLayoutText from '../../../../src/sandbox/csr-auth/src/routes/layout-tsx.txt';
 import srcRoutesAuthText from '../../../../src/sandbox/csr-auth/src/routes/Auth-tsx.txt';
@@ -20,6 +21,7 @@ import srcRoutesProtectedPageText from '../../../../src/sandbox/csr-auth/src/rou
 import srcRoutesLoginPageText from '../../../../src/sandbox/csr-auth/src/routes/login/page-tsx.txt';
 
 <Sandpack template="web-app" files={{
+  ...ultramodernSandpackFiles,
   '/src/routes/page.tsx': srcRoutesPageText,
   '/src/routes/layout.tsx': srcRoutesLayoutText,
   '/src/routes/Auth.tsx': srcRoutesAuthText,

package/package.json

@@ -19,12 +19,13 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.8.2-ultramodern.9",
+  "version": "3.8.3-ultramodern.2",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.8.2-ultramodern.9",
+    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.8.3-ultramodern.2",
+    "@modern-js/ultramodern-sandpack-profile": "npm:@bleedingdev/modern-js-ultramodern-sandpack-profile@3.8.3-ultramodern.2",
     "mermaid": "^11.16.0"
   },
   "devDependencies": {

package/rspress.config.ts

@@ -1,44 +1,26 @@
 import { pluginSass } from '@rsbuild/plugin-sass';
-import { defineConfig } from '@rspress/core';
 import { transformerNotationHighlight } from '@shikijs/transformers';
 import path from 'path';
 import { pluginOpenGraph } from 'rsbuild-plugin-open-graph';
+import { defineUltraModernConfig as defineConfig } from './ultramodern-preset/src/index.ts';
 
 const docPath = path.join(__dirname, 'docs');
-const staticPath = path.join(__dirname, 'static');
-const siteTitle = 'UltraModern.js 3.0';
+const siteTitle = 'Modern.js';
 const siteDescription =
-  'UltraModern.js 3.0 is a SuperApp framework forked from Modern.js for Effect, TanStack Router, SSR, BFF, and independently deployable Micro Verticals.';
+  'The Modern.js framework is a progressive web framework based on React. At ByteDance, we use Modern.js to build upper-level frameworks that have supported the development of thousands of web applications.';
 const socialDescription =
-  'A SuperApp framework for Effect, TanStack Router, SSR, BFF, and Micro Verticals.';
-
-function normalizeBase(base = '/') {
-  const trimmed = base.trim();
-  const withLeadingSlash = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
-  return withLeadingSlash.endsWith('/')
-    ? withLeadingSlash
-    : `${withLeadingSlash}/`;
-}
-
-// Set by CI for GitHub Pages project sites. Defaults to root for local dev/custom domains.
-const docsBase = normalizeBase(process.env.DOCS_BASE);
-const docsOrigin = (
-  process.env.DOCS_ORIGIN || 'https://bleedingdev.github.io'
-).replace(/\/+$/, '');
-const siteUrl = new URL(docsBase, `${docsOrigin}/`).toString();
-const socialImage = new URL('img/social-card.svg', siteUrl).toString();
-const faviconUrl = new URL('img/favicon.ico', siteUrl).toString();
-const docsAsset = (assetPath: string) =>
-  `${docsBase}${assetPath.replace(/^\//, '')}`;
+  'A Progressive React Framework for modern web development.';
+const socialImage =
+  'https://lf3-static.bytednsdoc.com/obj/eden-cn/nuvjhpqnuvr/modern-website/banner.jpeg';
 
 export default defineConfig({
   root: docPath,
   llms: true,
   title: siteTitle,
   description: siteDescription,
-  base: docsBase,
-  logo: docsAsset('/img/logo.svg'),
-  icon: faviconUrl,
+  base: '/',
+  logo: 'https://lf-cdn-tos.bytescm.com/obj/static/webinfra/modern-js-website/assets/images/images/modernjs-logo.svg',
+  icon: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/uhbfnupenuhf/favicon.ico',
   lang: 'en',
   themeDir: path.join(__dirname, 'src'),
   markdown: {
@@ -50,40 +32,24 @@ export default defineConfig({
   search: {
     codeBlocks: true,
   },
-  // head: [
-  //   () => {
-  //     return [
-  //       `<meta property="og:image" content="${socialImage}">`,
-  //       `<meta property="og:description" content="${socialDescription}">`,
-  //       `<meta property="og:image:alt" content="${siteTitle}">`,
-  //       `<meta name="twitter:card" content="summary_large_image">`,
-  //       `<meta name="twitter:title" content="${siteTitle}">`,
-  //       `<meta name="twitter:description" content="${socialDescription}">`,
-  //       `<meta name="twitter:image" content="${socialImage}">`,
-  //       `<meta name="twitter:image:alt" content="${siteTitle}">`,
-  //     ].join('');
-  //   },
-  // ],
   themeConfig: {
     locales: [
       {
         lang: 'zh',
         title: siteTitle,
         description: socialDescription,
-        // nav: getNavbar('zh'),
         label: '简体中文',
       },
       {
         lang: 'en',
         title: siteTitle,
         description: socialDescription,
-        // nav: getNavbar('en'),
         label: 'English',
       },
     ],
     editLink: {
       docRepoBaseUrl:
-        'https://github.com/BleedingDev/ultramodern.js/tree/main-ultramodern/packages/document/docs',
+        'https://github.com/web-infra-dev/modern.js/tree/main/packages/document/docs',
       text: 'Edit this page on GitHub',
     },
     socialLinks: [
@@ -95,7 +61,7 @@ export default defineConfig({
       {
         icon: 'github',
         mode: 'link',
-        content: 'https://github.com/BleedingDev/ultramodern.js',
+        content: 'https://github.com/web-infra-dev/modern.js',
       },
     ],
   },
@@ -105,7 +71,8 @@ export default defineConfig({
   },
   replaceRules: [
     {
-      // Preserve the upstream replacement contract for inherited docs.
+      // The major version is different inside the ByteDance,
+      // so we use a flag to define it.
       search: /MAJOR_VERSION/g,
       replace: '2',
     },
@@ -128,11 +95,6 @@ export default defineConfig({
     output: {
       dataUriLimit: 0,
     },
-    server: {
-      publicDir: {
-        name: staticPath,
-      },
-    },
     dev: {
       lazyCompilation: process.env.LAZY !== 'false',
     },
@@ -147,15 +109,15 @@ export default defineConfig({
       pluginSass(),
       pluginOpenGraph({
         // Note, title is page-specific
-        title: 'UltraModern.js 3.0 Home Page',
+        title: 'Modern.js Home Page',
         // While site name is site wide
         siteName: siteTitle,
         type: 'website',
-        url: siteUrl,
+        url: 'https://modernjs.dev/',
         image: socialImage,
         description: socialDescription,
         twitter: {
-          site: '@BleedingDev',
+          site: '@_Modern_JS',
           card: 'summary_large_image',
         },
       }),

package/src/sandbox/csr-auth/src/routes/Auth-tsx.txt

@@ -1,4 +1,8 @@
-import { Navigate, useLocation, useNavigate } from '@modern-js/runtime/router';
+import {
+  Navigate,
+  useLocation,
+  useNavigate,
+} from '@modern-js/plugin-tanstack/runtime';
 import React from 'react';
 import { fakeAuthProvider } from './fakeAuth';
 
@@ -49,7 +53,7 @@ export function AuthStatus() {
       <button
         type="button"
         onClick={() => {
-          auth.signout(() => navigate('/'));
+          auth.signout(() => void navigate({ to: '/' }));
         }}
       >
         Sign out
@@ -67,7 +71,13 @@ export function RequireAuth({ children }: { children: JSX.Element }) {
     // trying to go to when they were redirected. This allows us to send them
     // along to that page after they login, which is a nicer user experience
     // than dropping them off on the home page.
-    return <Navigate to="/login" state={{ from: location }} replace />;
+    return (
+      <Navigate
+        replace
+        search={{ redirect: location.pathname }}
+        to="/login"
+      />
+    );
   }
 
   return children;

package/src/sandbox/csr-auth/src/routes/layout-tsx.txt

@@ -1,4 +1,4 @@
-import { Link, Outlet } from '@modern-js/runtime/router';
+import { Link, Outlet } from '@modern-js/plugin-tanstack/runtime';
 import { AuthProvider, AuthStatus } from './Auth';
 
 export default function Layout() {
@@ -8,10 +8,10 @@ export default function Layout() {
 
       <ul>
         <li>
-          <Link to="/">Public Page</Link>
+          <Link prefetch="render" to="/">Public Page</Link>
         </li>
         <li>
-          <Link to="/protected">Protected Page</Link>
+          <Link prefetch="render" to="/protected">Protected Page</Link>
         </li>
       </ul>
 

package/src/sandbox/csr-auth/src/routes/login/page-tsx.txt

@@ -1,4 +1,7 @@
-import { useLocation, useNavigate } from '@modern-js/runtime/router';
+import {
+  useLocation,
+  useNavigate,
+} from '@modern-js/plugin-tanstack/runtime';
 import { useAuth } from '../Auth';
 
 export default function Login() {
@@ -6,7 +9,8 @@ export default function Login() {
   const location = useLocation();
   const auth = useAuth();
 
-  const from = location.state?.from?.pathname || '/';
+  const from =
+    new URLSearchParams(location.searchStr).get('redirect') || '/';
 
   function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
     event.preventDefault();
@@ -21,7 +25,7 @@ export default function Login() {
       // when they get to the protected page and click the back button, they
       // won't end up back on the login page, which is also really nice for the
       // user experience.
-      navigate(from, { replace: true });
+      void navigate({ replace: true, to: from });
     });
   }
 

package/ultramodern-preset/assets/img/ultramodern-logo-dark.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="220" height="48" viewBox="0 0 220 48" role="img" aria-labelledby="title">
+  <title id="title">UltraModern.js</title>
+  <rect width="48" height="48" rx="12" fill="#020617"/>
+  <path fill="#14b8a6" d="M13 13h7v13c0 5 2.6 8 7 8s7-3 7-8V13h7v13c0 8.8-5.6 14-14 14s-14-5.2-14-14V13z"/>
+  <path fill="#38bdf8" d="M31 13h8v27h-8V13z"/>
+  <text x="60" y="31" fill="#f8fafc" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="23" font-weight="700">UltraModern.js</text>
+</svg>

package/ultramodern-preset/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@modern-js/ultramodern-docs-preset",
+  "version": "3.8.3",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node --test tests/*.test.ts"
+  },
+  "engines": {
+    "node": ">=26.7.0"
+  },
+  "dependencies": {
+    "rsbuild-plugin-open-graph": "1.1.3"
+  },
+  "devDependencies": {
+    "@rspress/core": "2.0.17",
+    "@types/node": "^26.2.0"
+  }
+}