Skip to main content

Function: defineConfig()

defineConfig<TComponents, TSchemas>(config): ZodFormsConfig<TComponents, TSchemas>

Defined in: packages/core/src/config.ts:431

Identity helper that returns its argument typed as ZodFormsConfig.

Merges preset component overrides (e.g. shadcn) into config.components.overrides so that user-supplied overrides layer on top of the preset defaults. Use this in your z2f.config.ts to get full TypeScript inference and IDE autocompletion.

Type Parameters​

TComponents​

TComponents extends Record<string, unknown> = Record<string, unknown>

TSchemas​

TSchemas extends Record<string, unknown> = Record<string, unknown>

Parameters​

config​

ZodFormsConfig<TComponents, TSchemas>

The raw configuration object.

Returns​

ZodFormsConfig<TComponents, TSchemas>

The same configuration with preset overrides applied.

Remarks​

Identity helper that returns its argument typed as ZodFormsConfig. Applies preset component overrides (e.g., shadcn) — preset defaults merge with user overrides, user wins on conflicts. However, the props dict is replaced entirely, not merged.

Use When​

  • Writing z2f.config.ts for CLI codegen (primary use case)
  • You want TypeScript inference and IDE autocompletion for config

Avoid When​

  • Runtime-only usage where you pass config inline to walkSchema

Pitfalls​

  • NEVER assume preset props merge with your props — the entire props dict is replaced. If you set component props, you must include ALL props including the ones from the preset

Example​

export default defineConfig({
  components: { source: '@/components/ui', preset: 'shadcn' },
});