VitePress

This is an example of how to set up a static site with VitePress on Kinsta’s Static Site Hosting services from a GitHub repository.

VitePress is a Vite and Vue Powered Static Site Generator. More information is available on the vitepress.dev website.

You can also use this quick start template on Kinsta’s Application Hosting without any additional configuration. If you use Application Hosting, the Start command can be left blank for the web process as Kinsta automatically detects the required command during the first deployment.

Prerequisites

  • Kinsta’s quick start templates are stored and managed in GitHub; therefore, you need a GitHub account to access them.
  • You need to create a MyKinsta account to deploy the application.

Deploy a VitePress Static Site

  1. Log in to GitHub and create a new repository from this template (Use this template > Create a new repository): Kinsta – Hello World – Static Site With VitePress.
  2. In MyKinsta, click Static Sites > Add site > select GitHub, click Connect git provider > Authorize, and log in to your GitHub account.
  3. Choose the Hello World VitePress repository, click Continue, and enter the following in the Build settings:
    • Build command: npm run build
    • Node version: 18.16.0
    • Publish directory: .vitepress/dist

During the deployment process, Kinsta automatically installs dependencies defined in your package.json file. The site is available as soon as the deployment finishes, and the default VitePress page loads at your site’s URL.

VitePress default page after successful deployment of VitePress.
VitePress default page after successful deployment of VitePress.

Deployment Lifecycle

Whenever a deployment is initiated (through creating a static site or re-deploying due to an incoming commit), the build command is run, followed by the deployment of the Publish Directory content.