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

VuePress is a static site generator that allows you to embed dynamic content within your Markdown files using Vue components to produce static HTML pages. More information is available on the VuePress website.

Kinsta automatically installs dependencies defined in your composer.json file during the deployment process.

Static Site Hosting

  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 VuePress
  2. In MyKinsta, add an application with the Hello World VuePress repository and the following Build settings:
    • Build command: npm run build
    • Node version: 16.20.0
    • Publish directory: ./docs/.vuepress/dist
  3. The site is available as soon as the build finishes, and the Hello world page loads at your site’s URL.

Application Hosting

  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 VuePress
  2. In MyKinsta, add an application with the Hello World VuePress repository. The Start command can be left blank for the web process as Kinsta automatically detects the required command during the first deployment.
  3. The app is available as soon as the build finishes, and the Hello world page loads at your application’s URL.

Web Server Setup

Port

Kinsta automatically sets the PORT environment variable. You do not need to define it or hard-code it into the application. The serve package utilizes the port set by Kinsta automatically.

Start Command

When you deploy the application, Kinsta automatically creates a web process with npm start as the Start command.

Deployment Lifecycle

Whenever you initiate a deployment (through creating an application or re-deploying due to an incoming commit), the npm build the command is run, followed by the npm start command.

Hello World Page

The app or site is available as soon as the build finishes, and the Hello World page loads at your application’s URL or static site’s URL.

VuePress application
VuePress application.