Skip to content

xtarterize · conformance CLI

The conformance CLI for JavaScript & TypeScript

Detects your stack. Validates your configs. Keeps everything in sync without overwriting a single file unless you say so.

xtarterize · dry run

Example output: npx xtarterize 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

Five steps, every run: read the project, resolve tasks, compare files, show the plan, apply with backups.

  1. Detect

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

  2. Resolve

    Map that profile to the conformance tasks that apply to your stack.

  3. Check

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

  4. Plan

    Review the conformance plan before anything is written.

  5. Apply

    Back up originals, then merge or rewrite configs.

safety model

Nothing moves without you

Built for repos you care about. Changes are previewed, originals are backed up, and writes happen only when you approve.

  • Preview the plan

    Run init or sync with --dry-run first. It prints every planned change before anything touches your files.

  • 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: everything, selected tasks, dry run, or quit. Conflicts surface instead of overwriting your configs.

task catalog

What it can manage

Task groups cover linting, types, CI, editor setup, agent skills, Vite plugins, and more. Each task is small enough to review at a glance.

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.