image: node:20

stages:
  - pages

cache:
  # The cache is shared for same values of cache key
  # Here, we use CI_PIPELINE_ID which is defined as:
  # "The instance-level ID of the current pipeline. This ID is unique across all projects on the GitLab instance."
  # This should ensure that we only cache the "node_modules" folder for this given pipeline instance.
  # Refer to this docs to know more about the predefined variables used in the key here: https://docs.gitlab.com/ee/ci/variables/predefined_variables.html
  key: $CI_PIPELINE_ID
  # configure the path to be cached
  paths:
    - node_modules/

before_script:
    - npm install
    - npm run build

# Publish the documentation to GitLab Pages (for now).
pages:
  stage: publish
  script:
    - npm run docs:build
    - mv docs/.vitepress/dist public
  artifacts:
    paths:
      - public
  only:
    - main