Quick Start

1. Initialize the project

Method 1: Create via CLI

You can create a Rspress project using the create-rspress cli:

npm create rspress@latest

Input the project directory name, and then the cli will create the project for you.

Method 2: Manual Creation

First, you can create a new directory with the following command:

mkdir rspress-app && cd rspress-app

Execute npm init -y to initialize a project. You can install Rspress using npm, yarn or pnpm:

npm install rspress typescript ts-node -D

Then create the file with the following command

mkdir docs && echo '# Hello World' > docs/index.md

Add the following script to package.json:

  "scripts": {
    "dev": "rspress dev",
    "build": "rspress build",
    "preview": "rspress preview"

Then initialize a configuration file rspress.config.ts:

import { defineConfig } from 'rspress/config';

export default defineConfig({
  root: 'docs',

And then create tsconfig.json, add the following config:

  "compilerOptions": {
    "esModuleInterop": true,
    "jsx": "react-jsx"

2. Start Dev Server

Start the local development service with the following command:

npm run dev

For the dev command, you can specify the port number or host of the development service with the --port or --host parameter, such as rspress dev --port 8080 --host

3. Build in Production

Build the production bundle with the following command :

npm run build

By default, Rspress will set doc_build as the output directory.

4. Preview in local environment

Start the local preview service with the following command:

npm run preview