dokrypt ci

Usage

dokrypt ci <subcommand> [flags]

Subcommands

Subcommand	Description
`generate`	Generate CI/CD workflow files
`validate`	Validate existing CI workflow

generate

Generate a CI/CD pipeline configuration file for your project.

dokrypt ci generate [flags]

Flags

Flag	Type	Default	Description
`--provider`	`string`	`github`	CI provider: `github`, `gitlab`
`--output`	`string`	`.`	Output directory for generated files
`--deploy`	`bool`	`false`	Include testnet deployment step

Supported Providers

Provider	Flag Value	Generated File
GitHub Actions	`github`	`.github/workflows/dokrypt.yml`
GitLab CI	`gitlab`	`.gitlab-ci.yml`

Examples

GitHub Actions (default)

dokrypt ci generate

Generates .github/workflows/dokrypt.yml with test job.

GitHub Actions with deploy

dokrypt ci generate --deploy

Adds a deploy-testnet job that runs after tests pass on the main branch.

GitLab CI

dokrypt ci generate --provider gitlab

Generates .gitlab-ci.yml with Docker-in-Docker service.

Custom output directory

dokrypt ci generate --output ./ci-config

Generated Pipeline Steps

Every generated workflow includes:

Install Dokrypt via npm
Run dokrypt doctor to verify prerequisites
Start environment with dokrypt up --detach --fresh
Wait for services with dokrypt status --wait --timeout 60s
Run tests with dokrypt test run --json
Upload results as build artifact
Clean up with dokrypt down --volumes (runs even on failure)

Config Integration

If your project has a dokrypt.yaml with test settings, the generated workflow respects them:

# dokrypt.yaml
tests:
  gas_report: true
  coverage: true

The generated workflow will include --gas-report --coverage flags automatically.

validate

Check that an existing CI workflow file contains the required Dokrypt steps.

dokrypt ci validate

What It Checks

Check	Looks For
Code checkout	`actions/checkout`
Environment startup	`dokrypt up`
Test execution	`dokrypt test`
Environment cleanup	`dokrypt down`

Example Output

Found GitHub Actions workflow: .github/workflows/dokrypt.yml
  Environment startup      ok
  Test execution           ok
  Environment cleanup      ok
  Code checkout            ok
Workflow is valid

Overview

Project Lifecycle

Blockchain Operations

Testing & CI

Deployment & Verification

Configuration & Templates

System

Usage

Subcommands

generate

Flags

Supported Providers

Examples

GitHub Actions (default)

GitHub Actions with deploy

GitLab CI

Custom output directory

Generated Pipeline Steps

Config Integration

validate

What It Checks

Example Output

​Usage

​Subcommands

​generate

​Flags

​Supported Providers

​Examples

​GitHub Actions (default)

​GitHub Actions with deploy

​GitLab CI

​Custom output directory

​Generated Pipeline Steps

​Config Integration

​validate

​What It Checks

​Example Output

Usage

Subcommands

generate

Flags

Supported Providers

Examples

GitHub Actions (default)

GitHub Actions with deploy

GitLab CI

Custom output directory

Generated Pipeline Steps

Config Integration

validate

What It Checks

Example Output