You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
vitepress/docs/guide/getting-started.md

1.4 KiB

Getting Started

This section will help you build a basic VitePress documentation site from ground up. If you already have an existing project and would like to keep documentation inside the project, start from Step 3.

::: warning VitePress is currently in alpha status. It is already suitable for out-of-the-box documentation use, but the config and theming API may still change between minor releases. :::

Step. 1

Create and change into a new directory.

$ mkdir vitepress-starter && cd vitepress-starter

Step. 2

Initialize with your preferred package manager.

$ yarn init

Step. 3

Install VitePress.

$ yarn add --dev vitepress

Step. 4

Create your first document.

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

Step. 5

Add some scripts to package.json.

{
  ...
  "scripts": {
    "docs:dev": "vitepress dev docs",
    "docs:build": "vitepress build docs",
    "docs:serve": "vitepress serve docs"
  },
  ...
}

Step. 6

Serve the documentation site in the local server.

$ yarn docs:dev

VitePress will start a hot-reloading development server at http://localhost:3000.

What's next?

By now, you should have a basic but functional VitePress documentation site.

When your documentation site starts to take shape, be sure to read the deployment guide.