generated output
Commit generated contracts only when the app imports them.
Sync writes runtime metadata and state under .db/. That directory usually stays uncommitted. Configured generated types, manifests, and operation refs can be committed when they are part of the application contract.
Output policy
| Output | Path | Commit? |
|---|---|---|
| Runtime state | .db/state/*.json | No, unless a task explicitly asks for runtime state. |
| Generated types | outputs.committedTypes | Yes, when TypeScript imports need a fresh-checkout contract. |
| Schema manifest | outputs.schemaManifest | Yes, when a local UI imports field metadata. |
| Viewer manifest | outputs.viewerManifest | Yes, when a custom viewer imports route and capability metadata. |
| Operation refs | outputs.operationRefs | Yes, when client code imports approved callable refs. |
| Operation registry | outputs.operationRegistry | Server-side only. Do not ship full templates to browser code. |
Generated contract config
export default defineConfig({
outputs: {
committedTypes: './src/generated/db.types.d.ts',
schemaManifest: './src/generated/db.schema.json',
operationRefs: './src/generated/db.operation-refs.json',
},
});Examples that commit contracts
basicadvancedproduction-jsonschema-manifestschema-uicomputed-fieldscontent-collections