GitLab Pages

Deploy your Dustavez site to GitLab Pages using GitLab CI/CD pipelines.

GitLab Pages provides free static hosting integrated with GitLab CI/CD. Your documentation builds and deploys automatically on every push.

CI/CD configuration

Create a .gitlab-ci.yml file in your project root:

image: node:22

pages:
  stage: deploy
  script:
    - npm ci
    - npm run build
    - mv dist public
  artifacts:
    paths:
      - public
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

Output directory

GitLab Pages requires the output directory to be named public. The pipeline moves dist to public after building.

Setup

Add the CI config

Commit .gitlab-ci.yml to your repository root.

Push to GitLab

Push your changes. The pipeline runs automatically and deploys your site.

Access your site

Your site is available at https://<username>.gitlab.io/<project-name>/.

Custom domain

Go to Settings > Pages in your GitLab project
Click New Domain and enter your custom domain
Configure a CNAME record pointing to <username>.gitlab.io
Optionally, let GitLab provision a TLS certificate via Let’s Encrypt

Last updated: April 4, 2026

Edit this page on GitHub

← Previous

CI/CD automation

Self-Hosted