divekit dev

Scan for unresolved tokens and variation value candidates

Synopsis

Development helper for finding and fixing token issues.

Scans the current project for unresolved variation tokens and suggests values that should be added to variation.json. Essential for debugging individualization issues before distribution.

Detected Issues

  • Unresolved tokens (tokens without values in variation.json)
  • Possible variable residues from other variations
  • Missing token definitions
  • Template syntax issues like broken fragments or invalid placeholders (opt-in)
  • Suggested values based on context analysis

Scan Sources

  default               Scan the current origin project
  --scan-latest         Scan the latest output created by 'divekit distribute -p local'
  --scan-path           Scan an explicit path; if it points into .divekit/local-data it is treated as local distribution output
  --group-id            Restrict local distribution scans to one generated group

Usage

divekit dev [flags]

Examples

# Scan distribution for token issues
divekit dev -d ST2M4

# Watch mode for continuous development
divekit dev -d ST2M4 --watch

# Scan one generated local project or a local-data subtree
divekit dev -d ST2M4 --scan-path .divekit/local-data

# Scan the latest 'divekit distribute -p local' output for this distribution
divekit dev -d ST2M4 --scan-latest

# Restrict local distribution scanning to one generated group
divekit dev -d ST2M4 --scan-latest --group-id 8f9e52d-dcd5-44da-8bda-03ccb16a3b15

# Show only unresolved tokens
divekit dev -d ST2M4 --only-unresolved

# Show only value suggestions
divekit dev -d ST2M4 --only-suggestions

# Show only possible variable residues
divekit dev -d ST2M4 --only-residues

# Ignore generated assets in this run only
divekit dev -d ST2M4 --ignore-path '*.png,.idea/*'

# Restrict scan to selected file types
divekit dev -d ST2M4 --type-whitelist md,json,xml,java

# Export results to JSON
divekit dev -d ST2M4 --output results.json

# Scaffold missing variation objects into individualization.json
divekit dev -d ST2M4 --write-individualization

# Minimal output without context
divekit dev -d ST2M4 --no-context

# Scan for invalid placeholders and broken delimiter fragments
divekit dev -d ST2M4 --check-syntax

# Only run syntax-oriented checks
divekit dev -d ST2M4 --only-syntax

# Keep full terminal-clickable path:line links on every unresolved match line
divekit dev -d ST2M4 --terminal-links

# Show every unresolved match instead of collapsing with "... and N more"
divekit dev -d ST2M4 --show-all-matches

Flags

--check-syntax              Detect invalid placeholders and broken delimiter fragments
  -d, --distribution string       Distribution name (prompted if omitted)
      --group-id string           Restrict local distribution scans to one generated group UUID
      --ignore-path strings       Additional file/path ignore patterns for this run (repeatable or comma-separated)
      --no-context                Disable context lines in console output
      --only-residues             Show only possible variable residues in console output
      --only-suggestions          Show only suggestions in console output
      --only-syntax               Show only syntax checks (implies --check-syntax)
      --only-unresolved           Show only unresolved tokens in console output
      --output string             Write results JSON to this path (disabled by default)
      --scan-latest               Scan the latest local distribution output created by 'divekit distribute -p local'
      --scan-path string          Scan this path instead of the origin project; local-data paths are treated as local distribution output
      --show-all-matches          Show every unresolved match instead of collapsing lists
      --terminal-links            Repeat full path:line on each unresolved match line
      --type-whitelist strings    Restrict scanned file extensions for this run (repeatable or comma-separated, without dots)
      --watch                     Watch files and rescan on changes
      --write-individualization   Create or extend individualization.json from unresolved tokens

Inherited Flags

-l, --loglevel string   log level (debug, info, warn, error, fatal) (default "info")
      --no-index          skip project index update
      --non-interactive   run in non-interactive mode (fails if interactive input is required)
  -y, --yes               assume yes/default for all prompts (non-interactive with automatic defaults)