---
title: Validate a Polaris change
description: Run the focused checks for Flagpole, Drift, and this documentation before publishing a change.
url: https://pr-15-c0fdf0ef9f59.thally.app/guides/work-with-the-cli
---

# Validate a Polaris change

Run the focused checks for Flagpole, Drift, and this documentation before publishing a change.

Run checks in the repository that owns the behavior. A product change is not
complete when only its documentation builds, and a docs-only change does not
need to rebuild both products.

## Flagpole

```bash
cd flagpole-api
npm test
npm run typecheck
npm run build
```

Update API documentation when a route, payload, error, environment variable,
or release identifier changes.

## Drift

```bash
cd driftkv
npm test
npm run build
```

The build runs TypeScript's compiler for the package; Drift does not define a
separate `typecheck` script.

Update package documentation when an export, method, option, event, error, or
runtime requirement changes.

## Documentation

```bash
cd polaris-labs-docs
npm ci --ignore-scripts --prefix .github/thally-tooling
.github/thally-tooling/node_modules/.bin/thally check --ci .
npm test
npm run build
```

`thally check` verifies frontmatter, navigation, internal links, and the
OpenAPI source. The application tests cover the runtime snapshot used to render
the customer-owned content.