Compatibility

SootSim’s compatibility data comes from a generated registry, not a hand-written “50+ stubs” list.

The source of truth is:

  • packages/compat/src/registry.ts
  • packages/compat/src/generated/site-snapshot.json
  • packages/compat/src/generated/site-scan-data.json

Check your project

terminal

sootsim compat

That scan classifies packages as:

  • Full support — the common runtime surface works
  • Partial support — major APIs work, but some behavior is still missing
  • Auto-stub — the package resolves through a basic fallback only
  • Unsupported — the package still depends on native SDK behavior
  • Not relevant — build/config packages tracked in the registry but excluded from runtime scoring

Regenerating the site snapshot

When the compat registry changes, regenerate the site data with:

terminal

bun scripts/generate-site-compat-snapshot.ts