Configuration

All options for safeRuntimeConfig in your nuxt.config.ts.

Options Reference

Example Configuration

export default defineNuxtConfig({
  safeRuntimeConfig: {
    $schema: runtimeConfigSchema,

    // Validation timing
    validateAtBuild: true, // default
    validateAtRuntime: false, // opt-in

    // Error handling
    onBuildError: 'throw', // stop build on error
    onRuntimeError: 'warn', // log warning, don't crash

    // Logging
    logSuccess: true,
    logFallback: true,

    // JSON Schema
    jsonSchemaTarget: 'draft-2020-12',
  },
})

Error Behaviors

'throw' (default)

Stops the build or throws an error at runtime. Recommended for catching issues early.

'warn'

Logs a warning but continues. Useful during migration or when some values are expected to be missing in development.

'ignore'

Silently continues. Use sparingly.

JSON Schema Target

The jsonSchemaTarget option controls which JSON Schema draft to use for runtime validation. Options:

• 'draft-2020-12' (default) - latest, best compatibility
• 'draft-2019-09' - if your tools require it
• 'draft-07' - legacy support

Runtime validation uses @cfworker/json-schema, a lightweight (~8KB) validator that works on all runtimes including edge.