Skip to content

xtarterize · conformance CLI

The conformance CLI for JavaScript & TypeScript

Detects your stack, validates your configs, and writes nothing without your approval.

xtarterize · dry run

Example output: pnpx xtarterize@latest init --dry-run detects the stack (react 19, vite 8, typescript 5.8, pnpm 10), plans 12 conformance tasks across 8 files, and previews each change before anything is written. Originals are backed up to .xtarterize/backups/.

How a run works

Every run follows the same five steps.

  1. Detect

    Profile the project: framework, bundler, package manager, existing configs.

  2. Resolve

    Map the profile to the conformance tasks that apply.

  3. Check

    Compare each file against the standard: new, patch, skip, or conflict.

  4. Plan

    Review the plan before anything is written.

  5. Apply

    Back up originals, then merge or rewrite configs.

safety model

Nothing moves without you

Preview every change, back up originals, and write only after you approve.

  • Preview the plan

    Run init or sync with --dry-run to preview every planned change; `.gitignore` may be created or updated, but no conformance files are written.

  • Backups by default

    Modified files are copied to .xtarterize/backups/ first. Undo and restore are built in.

  • You approve writes

    init asks before it applies, and conflicts surface instead of overwriting your configs.

task catalog

What it can manage

Task groups cover linting, types, CI, editor setup, agent skills, and Vite plugins.

Quick start

Three commands cover the loop.

Initialize conformance
npx xtarterize@latest init
Check conformance
npx xtarterize@latest check
Preview changes
npx xtarterize@latest diff

Starting from scratch?

create-xtarter-app scaffolds new projects on this same baseline.