CI/CD

Shevky builds are deterministic and well-suited for CI/CD pipelines. The core commands are:

npm ci
npm run build

The dist/ directory is the deployable artifact.

Generic Pipeline Steps

  1. Checkout - clone the repository.
  2. Setup Node - install Node.js 18+.
  3. Install dependencies - npm ci for reproducible installs.
  4. Build - npm run build to generate dist/.
  5. Deploy - upload dist/ to the target platform.

Example: GitHub Actions

See GitHub Pages for a complete workflow example.

Example: GitLab CI

build:
  image: node:20-alpine
  script:
    - npm ci
    - npm run build
  artifacts:
    paths:
      - dist/

Tips

  • Set build.minify: true and build.debug: false in CI builds.
  • Set identity.url to the production URL via a pre-build script or environment-specific config.
  • Plugin errors are logged but do not fail the build by default - consider adding a post-build validation step.

Related