ZD
ZeroDrift Cloud
AI Drift Validation

Getting Started with ZeroDrift

Integrate ZeroDrift with your NorthStar project in minutes. Choose standalone validation, cloud dashboards, or hybrid.

Integration Modes

Standalone

Run ZeroDrift locally on your NorthStar files. Perfect for development and testing.

npm install zerodrift

Cloud Connected

Connect to ZeroDrift Cloud for dashboards, reports, and team access.

zerodrift cloud:connect

CI/CD Integration

Fail builds if drift exceeds your threshold. Automated compliance gates.

npx zerodrift validate

Quick Start

Five simple steps to get ZeroDrift running with your NorthStar project.

1

Complete your NorthStar

Ensure your northstar.md file includes all guardrails and architecture decisions.

2

Install ZeroDrift

npm install zerodrift or use the CLI globally.

3

Run your first validation

zerodrift validate to get your baseline score.

4

Connect to Cloud (optional)

zerodrift cloud:connect for dashboards and team sharing.

5

Add CI gate (optional)

Add npx zerodrift validate --threshold=75 to your CI/CD pipeline.

CI/CD Pipeline Example

Add ZeroDrift validation as a required gate in GitHub Actions:

name: Validate ZeroDrift
on: [push, pull_request]
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: npm install zerodrift
      - run: npx zerodrift validate --threshold=75