diff --git a/website/docs/en/guide/quick-start.mdx b/website/docs/en/guide/quick-start.mdx
index bb5ae672..e5e28352 100644
--- a/website/docs/en/guide/quick-start.mdx
+++ b/website/docs/en/guide/quick-start.mdx
@@ -1,12 +1,12 @@
---
-description: 'Install Rstack CLI, add project scripts, and configure the Rstack JavaScript toolchain.'
+description: 'Create a Rstack project or add Rstack CLI to an existing project and configure the Rstack JavaScript toolchain.'
---
# Quick start
import { PackageManagerTabs } from '@rspress/core/theme';
-Rstack CLI brings the Rstack toolchain together with one CLI and one configuration file. This guide adds Rstack to an existing project and introduces the available workflows.
+Rstack CLI brings the Rstack toolchain together with one CLI and one configuration file. This guide shows how to create a new Rstack project or add Rstack to an existing project, and introduces the available workflows.
## Environment preparation
@@ -24,6 +24,95 @@ Rstack requires Node.js 22.12.0 or higher when using Node.js as the runtime.
:::
+## Create a Rstack project
+
+[create-rstack](https://www.npmjs.com/package/create-rstack) lets you quickly create an application, library, or documentation site with Rstack configured. We recommend using [pnpm](https://pnpm.io/) as your package manager.
+
+
+
+Follow the prompts to complete the setup.
+
+After creating the project, do the following:
+
+- Run `pnpm install` (or your package manager's install command) to install dependencies.
+- Run `pnpm run dev` to start the development server or watch mode.
+
+### Templates
+
+When creating a project, choose from the following templates provided by `create-rstack`:
+
+| Project type | Templates |
+| ------------------ | ---------------------------------------------------------- |
+| Web application | Vanilla JavaScript, React, Preact, Vue, Lit, Svelte, Solid |
+| Library | Node.js, React, Vue, Svelte, Solid |
+| Documentation site | Single language, multilingual |
+
+All application and library templates are available in both JavaScript and TypeScript.
+
+### Current directory
+
+To create a project in the current directory, set the project name or path to `.`:
+
+```
+◆ Create Rstack Project
+│
+◇ Project name or path
+│ .
+│
+◇ "." is not empty, please choose:
+│ Continue and override files
+```
+
+### Non-interactive mode
+
+[create-rstack](https://www.npmjs.com/package/create-rstack) supports a non-interactive mode via command-line options. This mode skips prompts and creates the project directly, which is useful for scripts, CI, and automation.
+
+For example, the following command creates a TypeScript React application in the `my-project` directory:
+
+```bash
+npx -y create-rstack@latest my-project --template app-react-ts
+
+# Using abbreviations
+npx -y create-rstack@latest my-project -t app-react-ts
+
+# Skip Git repository initialization
+npx -y create-rstack@latest my-project -t app-react-ts --no-git
+```
+
+All CLI flags supported by `create-rstack`:
+
+```
+Usage: create-rstack [dir] [options]
+
+Options:
+
+ -h, --help display help for command
+ -d, --dir
create project in specified directory
+ -t, --template specify the template to use
+ --no-git skip Git repository initialization
+ --override override files in target directory
+ --packageName specify the package name
+ --template-version specify the npm template version
+
+Available templates:
+
+ app-vanilla-js, app-vanilla-ts, app-react-js, app-react-ts,
+ app-preact-js, app-preact-ts, app-vue-js, app-vue-ts,
+ app-lit-js, app-lit-ts, app-svelte-js, app-svelte-ts,
+ app-solid-js, app-solid-ts, lib-node-js, lib-node-ts,
+ lib-react-js, lib-react-ts, lib-vue-js, lib-vue-ts,
+ lib-svelte-js, lib-svelte-ts, lib-solid-js, lib-solid-ts,
+ doc-basic, doc-i18n
+```
+
## Install Rstack
Install [`rstack`](https://www.npmjs.com/package/rstack) as a development dependency in a project that has a `package.json`:
diff --git a/website/docs/zh/guide/quick-start.mdx b/website/docs/zh/guide/quick-start.mdx
index 697dfe73..101fae90 100644
--- a/website/docs/zh/guide/quick-start.mdx
+++ b/website/docs/zh/guide/quick-start.mdx
@@ -1,12 +1,12 @@
---
-description: '安装 Rstack CLI、添加项目脚本,并配置 Rstack JavaScript 工具链。'
+description: '创建 Rstack 项目,或在现有项目中安装 Rstack CLI 并配置 Rstack JavaScript 工具链。'
---
# 快速上手 \{#quick-start}
import { PackageManagerTabs } from '@rspress/core/theme';
-Rstack CLI 通过统一的命令行和配置文件整合 Rstack 工具链。本指南将介绍如何在现有项目中添加 Rstack,以及可以使用的工作流。
+Rstack CLI 通过统一的命令行和配置文件整合 Rstack 工具链。本指南将介绍如何创建新的 Rstack 项目或在现有项目中添加 Rstack,以及可以使用的工作流。
## 环境准备 \{#environment-preparation}
@@ -24,6 +24,95 @@ Rstack 支持使用 [Node.js](https://nodejs.org/)、[Deno](https://deno.com/)
:::
+## 创建 Rstack 项目 \{#create-a-rstack-project}
+
+使用 [create-rstack](https://www.npmjs.com/package/create-rstack) 可以快速创建已配置好 Rstack 的应用、库或文档站点。推荐使用 [pnpm](https://pnpm.io/) 作为包管理器。
+
+
+
+按照提示操作即可完成创建。
+
+项目创建完成后,执行以下步骤:
+
+- 执行 `pnpm install`(或其他包管理器的 install 命令)安装依赖。
+- 执行 `pnpm run dev` 启动开发服务器或监听模式。
+
+### 模板 \{#templates}
+
+创建项目时,可选择 `create-rstack` 提供的下列模板:
+
+| 项目类型 | 模板 |
+| -------- | ------------------------------------------------------- |
+| Web 应用 | 原生 JavaScript、React、Preact、Vue、Lit、Svelte、Solid |
+| 库 | Node.js、React、Vue、Svelte、Solid |
+| 文档站点 | 单语言、多语言 |
+
+所有应用和库模板均提供 JavaScript 和 TypeScript 版本。
+
+### 当前目录 \{#current-directory}
+
+如需在当前目录中创建项目,将项目名称或路径设置为 `.`:
+
+```
+◆ Create Rstack Project
+│
+◇ Project name or path
+│ .
+│
+◇ "." is not empty, please choose:
+│ Continue and override files
+```
+
+### 非交互模式 \{#non-interactive-mode}
+
+[create-rstack](https://www.npmjs.com/package/create-rstack) 支持通过命令行选项进入非交互模式。该模式会跳过提示并直接创建项目,适合脚本、CI 和自动化场景。
+
+例如,以下命令将在 `my-project` 目录中创建一个 TypeScript React 应用:
+
+```bash
+npx -y create-rstack@latest my-project --template app-react-ts
+
+# 使用缩写
+npx -y create-rstack@latest my-project -t app-react-ts
+
+# 跳过 Git 仓库初始化
+npx -y create-rstack@latest my-project -t app-react-ts --no-git
+```
+
+`create-rstack` 支持的全部 CLI 选项如下:
+
+```
+Usage: create-rstack [dir] [options]
+
+Options:
+
+ -h, --help display help for command
+ -d, --dir create project in specified directory
+ -t, --template specify the template to use
+ --no-git skip Git repository initialization
+ --override override files in target directory
+ --packageName specify the package name
+ --template-version specify the npm template version
+
+Available templates:
+
+ app-vanilla-js, app-vanilla-ts, app-react-js, app-react-ts,
+ app-preact-js, app-preact-ts, app-vue-js, app-vue-ts,
+ app-lit-js, app-lit-ts, app-svelte-js, app-svelte-ts,
+ app-solid-js, app-solid-ts, lib-node-js, lib-node-ts,
+ lib-react-js, lib-react-ts, lib-vue-js, lib-vue-ts,
+ lib-svelte-js, lib-svelte-ts, lib-solid-js, lib-solid-ts,
+ doc-basic, doc-i18n
+```
+
## 安装 Rstack \{#install-rstack}
在已有 `package.json` 的项目中,将 [`rstack`](https://www.npmjs.com/package/rstack) 安装为开发依赖: