Configuration
Watch options
Configure ozzyrm watch debounce, generate-on-start, and the hot stamp bridge.
watch controls the ozzyrm watch CLI and an optional hot-reload stamp for React bundlers. Production loadCatalog ignores watch options.
Forms
// disable the watcher entirely
watch: false
// enable with defaults
watch: true
// object form
watch: {
enabled: true,
debounceMs: 200,
generateOnStart: true,
hot: true,
}Fields
| Field | Type | Default | Purpose |
|---|---|---|---|
enabled | boolean | true when object/true | When false, ozzyrm watch is a no-op |
debounceMs | number | 200 | Wait after file changes before regenerate |
generateOnStart | boolean | true | Run one generate when watch starts |
hot | boolean | false | Write .ozzyrm/stamp.js so bundlers can invalidate |
Hot stamp bridge
When hot: true, each successful generate writes an allowlisted .ozzyrm/stamp.js. Server helpers that import the stamp (for example OzzyRMDocsFromConfig) let the bundler reload after schema file edits while ozzyrm watch is running.
npx ozzyrm watch # terminal 1
# your React app dev server in terminal 2Without the watcher, refresh the page after schema edits (or use your framework's equivalent of a dynamic server render).
Stamp contents are validated before import. Arbitrary JavaScript in
stamp.js is rejected.