@modern-js/main-doc 0.0.0-nightly-20250518160324 → 0.0.0-nightly-20250520160352

package/docs/en/configure/app/output/dist-path.mdx

@@ -17,7 +17,6 @@ type DistPathConfig = {
   wasm?: string;
   image?: string;
   media?: string;
-  server?: string;
   worker?: string;
   assets?: string;
 };

package/docs/en/configure/app/tools/html-plugin.mdx

@@ -33,6 +33,11 @@ const defaultOptions = {
 };
 ```
 
+:::warning
+SSR Application does not enable the `minify.removeComments` configuration, otherwise the SSR rendering will fail.
+:::
+
+
 The configs of [html-rspack-plugin](https://github.com/rspack-contrib/html-rspack-plugin) or [html-webpack-plugin](https://github.com/jantimon/html-webpack-plugin) can be modified through `tools.htmlPlugin`.
 
 import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';

package/docs/en/configure/app/tools/swc.mdx

@@ -21,7 +21,7 @@ When using Rspack as the bundler, SWC will be used for transpiling and compressi
 
 You can set the options of [builtin:swc-loader](https://rspack.dev/guide/features/builtin-swc-loader) through `tools.swc`.
 
-```
+```ts
 import { defineConfig } from '@modern-js/app-tools';
 
 export default defineConfig<'rspack'>({

package/docs/en/guides/basic-features/deploy.mdx

@@ -285,6 +285,7 @@ Add the following script to `packages/app/package.json` to run `build` command o
 ```
 
 Add the following content to the `packages/app/vercel.json` file:
+
 ```json title="vercel.json"
 {
   "buildCommand": "npm run deploy",
@@ -298,7 +299,7 @@ Just submit your code and deploy it using the Vercel platform.
 
 If you're creating a GitHub Pages for a repository without a custom domain, the page URL will follow this format: `http://<username>.github.io/<repository-name>`. Therefore, you need to add the following configuration in `modern.config.ts`:
 
-```
+```ts
 import { defineConfig } from '@modern-js/app-tools';
 
 export default defineConfig({
@@ -331,7 +332,6 @@ For branch deployment, follow these steps:
 :::info
 1. Running `MODERNJS_DEPLOY=ghPages modern deploy` will build the production output for GitHub in the .output directory.
 2. You can refer to the [project](https://github.com/web-infra-dev/modern-js-examples/tree/main/examples/modern-js-deploy-csr)
-
 :::
 
 For GitHub Actions deployment, select Settings > Pages > Source > GitHub Actions, and add a workflow file to the project. You can refer to the [example](https://github.com/web-infra-dev/modern-js-examples/tree/main/examples/modern-js-deploy-csr).
@@ -407,7 +407,7 @@ Nginx is a high-performance HTTP and reverse proxy server that can handle static
 
 If your project is a purely front-end project, you can also deploy the application through Nginx. Here is an example of an Nginx configuration to demonstrate how to host the output of a purely front-end project.
 
-```conf title="nginx.conf"
+```nginx title="nginx.conf"
 # user [user] [group];
 worker_processes 1;
 

package/docs/en/guides/basic-features/output-files.mdx

@@ -96,7 +96,8 @@ dist
     └── qux.[hash].mp4
 ```
 
-## Node.js Output Directory
+
+<!-- ## Node.js Output Directory
 
 When you enable SSR or SSG features in Modern.js, Modern.js will generate a Node.js bundle after the build and output it to the `bundles` directory.
 
@@ -122,7 +123,7 @@ export default {
     },
   },
 };
-```
+``` -->
 
 ## Flatten the Directory
 

package/docs/zh/configure/app/output/dist-path.mdx

@@ -17,7 +17,6 @@ type DistPathConfig = {
   wasm?: string;
   image?: string;
   media?: string;
-  server?: string;
   worker?: string;
   assets?: string;
 };

package/docs/zh/configure/app/tools/html-plugin.mdx

@@ -33,6 +33,10 @@ const defaultOptions = {
 };
 ```
 
+:::warning
+SSR 应用请勿启用 `minify.removeComments` 配置项，否则会导致 SSR 渲染失败。
+:::
+
 通过 `tools.htmlPlugin` 可以修改 [html-rspack-plugin](https://github.com/rspack-contrib/html-rspack-plugin) 或 [html-webpack-plugin](https://github.com/jantimon/html-webpack-plugin) 的配置项。
 
 import RsbuildConfig from '@site-docs/components/rsbuild-config-tooltip';

package/docs/zh/configure/app/tools/swc.mdx

@@ -21,7 +21,7 @@ import SWC from '@site-docs/components/swc.mdx';
 
 通过 `tools.swc` 可以设置 Rspack [builtin:swc-loader](https://rspack.dev/zh/guide/features/builtin-swc-loader) 的选项。
 
-```
+```ts
 import { defineConfig } from '@modern-js/app-tools';
 
 export default defineConfig<'rspack'>({

package/docs/zh/guides/basic-features/deploy.mdx

@@ -110,7 +110,6 @@ Netlify 是一个流行的 Web 开发平台，专为构建、发布和维护现
 
 :::info
 你可参考部署[项目示例](https://github.com/web-infra-dev/modern-js-examples/tree/main/examples/modern-js-deploy-csr)。
-
 :::
 
 在 Netlify 平台上添加项目，部署即可。
@@ -197,6 +196,7 @@ Vercel 是一个面向现代 Web 应用的部署平台，它提供了丰富的
 ### 纯前端项目
 
 在当前项目的根目录添加 `vercel.json` 文件：
+
 ```bash
 ./
 ├── src
@@ -206,6 +206,7 @@ Vercel 是一个面向现代 Web 应用的部署平台，它提供了丰富的
 ```
 
 在 `vercel.json` 中添加以下内容：
+
 ```json title="vercel.json"
 {
   "buildCommand": "modern deploy",
@@ -219,7 +220,6 @@ Vercel 是一个面向现代 Web 应用的部署平台，它提供了丰富的
 
 :::info
 你可参考部署[项目示例](https://github.com/web-infra-dev/modern-js-examples/tree/main/examples/modern-js-deploy-csr)。
-
 :::
 
 ### 全栈项目
@@ -314,6 +314,7 @@ Github Pages 支持两种部署方式，通过分支部署或通过 Github Actio
 4. 执行 `npm run deploy:gh-pages`。
 
 :::info
+
 1. 执行 `MODERNJS_DEPLOY=ghPages modern deploy`，Modern.js 会把可用于 github 部署的产物构建到 `.output` 目录。
 2. 可以参考项目[示例](https://github.com/web-infra-dev/modern-js-examples/tree/main/examples/modern-js-deploy-csr)。
 
@@ -393,7 +394,7 @@ Nginx 是一个高性能的 HTTP 和反向代理服务器，它可以处理静
 
 如果你的项目是纯前端项目，也可以通过 Nginx 来部署应用，以下提供一个 Nginx 配置的示例来演示如何托管一个纯前端项目的产物。
 
-```conf title="nginx.conf"
+```nginx title="nginx.conf"
 # user [user] [group];
 worker_processes 1;
 

package/docs/zh/guides/basic-features/output-files.mdx

@@ -96,7 +96,7 @@ dist
     └── qux.[hash].mp4
 ```
 
-## Node.js 产物目录
+<!-- ## Node.js 产物目录
 
 当你在 Modern.js 中开启了 SSR 或 SSG 等服务端功能时，Modern.js 会在构建后生成一份 Node.js 产物，并输出到 `bundles` 目录下：
 
@@ -122,7 +122,7 @@ export default {
     },
   },
 };
-```
+``` -->
 
 ## 扁平化产物目录
 

package/package.json

@@ -15,19 +15,20 @@
     "modern",
     "modern.js"
   ],
-  "version": "0.0.0-nightly-20250518160324",
+  "version": "0.0.0-nightly-20250520160352",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "dependencies": {
     "mermaid": "^11.4.1",
-    "@modern-js/sandpack-react": "0.0.0-nightly-20250518160324"
+    "@modern-js/sandpack-react": "0.0.0-nightly-20250520160352"
   },
   "devDependencies": {
     "@rsbuild/plugin-sass": "1.3.1",
-    "@shikijs/transformers": "^3.4.1",
-    "@rspress/shared": "2.0.0-beta.5",
+    "@shikijs/transformers": "^3.4.2",
+    "@rspress/shared": "2.0.0-beta.6",
+    "@rspress/plugin-llms": "2.0.0-beta.6",
     "@types/fs-extra": "9.0.13",
     "@types/node": "^16",
     "classnames": "^2.5.1",
@@ -35,7 +36,7 @@
     "fs-extra": "^10",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "rspress": "2.0.0-beta.5",
+    "rspress": "2.0.0-beta.6",
     "ts-node": "^10.9.1",
     "typescript": "^5"
   },

package/rspress.config.ts

@@ -1,5 +1,6 @@
 import path from 'path';
 import { pluginSass } from '@rsbuild/plugin-sass';
+import { pluginLlms } from '@rspress/plugin-llms';
 import { transformerNotationHighlight } from '@shikijs/transformers';
 import { defineConfig } from 'rspress/config';
 
@@ -7,6 +8,9 @@ const docPath = path.join(__dirname, 'docs');
 
 export default defineConfig({
   root: docPath,
+  title: 'Modern.js',
+  description:
+    '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.',
   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',
@@ -18,6 +22,7 @@ export default defineConfig({
       transformers: [transformerNotationHighlight()],
     },
   },
+  plugins: [pluginLlms()],
   search: {
     codeBlocks: true,
   },
@@ -62,6 +67,11 @@ export default defineConfig({
       text: 'Edit this page on GitHub',
     },
     socialLinks: [
+      {
+        icon: 'discord',
+        mode: 'link',
+        content: 'https://discord.gg/qPCqYg38De',
+      },
       {
         icon: 'github',
         mode: 'link',