Targ Apps Docs
Workspace

JSON Schemas

Machine-readable JSON Schema catalog for TargApps application formats, published under /schemas/.

TargApps publishes JSON Schema (draft 2020-12) files for application-level JSON formats: finance persistence and backups, Chroma app manifests, plugin contracts, and workspace metadata.

Catalog

The manifest lists every published schema with stable ids and public URLs:

/schemas/index.json

{
  "version": 1,
  "schemas": [
    {
      "id": "targ-apps.finance.backup",
      "path": "/schemas/targ-apps/finance-backup.schema.json",
      "title": "Targ-Apps-Finance Backup Export",
      "project": "targ-apps-finance"
    }
  ]
}

Schemas are served as static files from targ-apps-docs/public/schemas/ (Fumadocs public/ directory).

Static config JSON in apps (e.g. Targ-Apps-Finance/chroma.json) should declare "$schema" as the first property with a full HTTPS URL:

{
  "$schema": "https://docs.targapps.xyz/schemas/targ-apps/chroma-app-manifest.schema.json",
  "name": "Targ-Apps-Finance"
}

Prefer targ-apps/ schemas for Targ-Apps-Finance manifests; use chroma/ or chroma-plugins/ for engine-level and first-party plugin sources.

TargApps application schemas (/schemas/targ-apps/)

SchemaFormatSource
finance-snapshot.schema.jsonfinance/snapshot.json persist snapshotTarg-Apps-Finance/logic/persist.js
finance-backup.schema.jsonSettings export/import JSON backuplogic/export.js, logic/import.js
settings.schema.jsonUser preferenceslogic/settings.js
account.schema.json … recurring-rule.schema.jsonFinance entitieslogic/models.js
profile.schema.json, session.schema.jsonLocal authlogic/auth.js
chroma-fs-config.schema.jsonchroma-fs.jsonIndexedDB / filesystem backends
chroma-app-manifest.schema.jsonchroma.jsonChroma dynamic apps
chroma-plugin-manifest.schema.jsonchroma.plugin.jsonplugins/<name>/
stage-registry.schema.jsonSerialized STAGE.md mapscripts/commit-stage.sh
shadcn-components-config.schema.jsoncomponents.jsontarg-apps/, targ-apps-page-vmaspad/

Example fixtures live under /schemas/targ-apps/examples/.

Chroma schemas

DirectorySchemas
/schemas/chroma/chroma.json, chroma-fs.json, chroma.plugin.json, pkg/package.json, jsconfig.json
/schemas/chroma-plugins/Plugin manifests, Chroma-Fs config, Chroma Router routes-manifest.json

All entries are listed in /schemas/index.json (24 schemas total).

Validate locally

cd targ-apps-docs/public/schemas

npx --yes ajv-cli@5 validate \
  -s targ-apps/finance-backup.schema.json \
  -d targ-apps/examples/finance-backup-sample.json \
  -r "targ-apps/*.schema.json" \
  --spec=draft2020

Full commands and -r reference resolution notes: /schemas/README.md.

On this page