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.

  • 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 locally.

    $ 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.

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.