Skip to content
xtarter

The conformance CLI for JavaScript & TypeScript

Detect your project's stack. Validate your configs. Keep everything in sync — without overwriting a single file without your say-so.
Get Started View CLI Reference
xtarterize — dry-run
❯ npx xtarterize init --dry-run
● Scanning project...
detected react 19 · vite 8 · typescript 5.8 · pnpm 10
plan 12 tasks · 8 files
Conformance plan
Status Task Group
──────────────────────────────────────────────
+ Biome (lint + format) Linting
~ tsconfig — strict: true TypeScript
+ GitHub Actions CI CI/CD
+ VS Code settings + ext. Editor
+ Agent skills AI
+ vite-plugin-checker Vite
❯ npx xtarterize diff
info Showing diffs for 8 files
+ biome.json +47 lines
~ tsconfig.json +3 / -1 lines
+ .github/workflows/ci.yml
+ .vscode/extensions.json
backup Originals saved to .xtarterize/backups/
❯ _

Why xtarterize?

Section titled “Why xtarterize?”

Every JavaScript/TypeScript project needs Biome (linting + formatting), TypeScript (strict mode), CI workflows (GitHub Actions), editor configs (VS Code), AI agent skills, and more. Setting them up is tedious. Keeping them consistent across projects is worse.

🔍

Detects your stack

Scans your project to understand what frameworks, tools, and configs you’re using — before touching anything.

🎯

Applies only what fits

Never gets in your way. Only suggests configs that match your detected tooling and project structure.

🛡️

Never destructive

Shows you a diff before any change. Backs up your files. You’re always in control.

🔄

Safe to rerun

Idempotent by design. Run it ten times — no duplicates, no corruption, no drift.

📈

Evolves with you

As your project grows, sync and diff keep your configs up to date without manual work.

⚡

Wide framework support

React, Vue, Svelte, Solid, Node, Bun — xtarterize detects your stack and applies what fits.

How it works

Section titled “How it works”
flowchart LR
    A["🔍 Detect<br/>Project Stack"] --> B["🎯 Resolve<br/>Applicable Tasks"]
    B --> C["✅ Check<br/>Task Statuses"]
    C --> D["📋 Plan<br/>Show Diffs"]
    D --> E["🚀 Apply<br/>With Backups"]

    style A fill:#6366f1,color:#fff
    style B fill:#8b5cf6,color:#fff
    style C fill:#a855f7,color:#fff
    style D fill:#d946ef,color:#fff
    style E fill:#22c55e,color:#fff

Quick Start

Section titled “Quick Start”

Get up and running in under a minute:

Terminal window
# 1. Initialize conformance for your project
npx xtarterize init


# 2. Check your current conformance status
npx xtarterize check


# 3. Preview what changes sync would make
npx xtarterize diff
Install xtarterize →

Explore the docs

Section titled “Explore the docs”
Getting Started Learn the basics and set up your first project in minutes.
CLI Reference Complete command reference with all flags and options.
Conformance Tasks See what tasks are available and how to customize them.
Configuration How xtarterize detects and adapts to your project.
Architecture Understand the internal design and package structure.
Project Detection How xtarterize discovers your project's stack.
Contributing Get involved, report issues, or help build xtarterize.

New project or existing?

Section titled “New project or existing?”

xtarterize works with both:

ToolWhen to use
create-xtarter-appDay 0 — Scaffold a new project from curated templates
xtarterizeDay 1+ — Bring conformance to any existing project

References

Section titled “References”
Start now →