nuxt-config

name	nuxt-config
description	Nuxt and app configuration files. Use when configuring nuxt.config.ts, app.config.ts, environment variables, runtime config, or understanding how configuration flows through the application.

Nuxt Configuration

Application configuration via nuxt.config.ts and app.config.ts.

Core Concepts

config.md - Complete configuration patterns

nuxt.config.ts

export default defineNuxtConfig({
  ssr: false,  // SPA mode

  extends: [
    '../../../nuxt-layers/base',
    '../../../nuxt-layers/shadcn-nuxt',
    '../../../nuxt-layers/x-ui',
  ],

  modules: ['shadcn-nuxt'],

  components: [{ path: 'components', pathPrefix: false }],

  runtimeConfig: {
    public: {
      apiUrl: undefined,  // Set via NUXT_PUBLIC_API_URL
      keycloak: {
        url: process.env.NUXT_PUBLIC_KEYCLOAK_URL,
        realm: process.env.NUXT_PUBLIC_KEYCLOAK_REALM,
        clientId: process.env.NUXT_PUBLIC_KEYCLOAK_CLIENT_ID,
      },
    },
  },
})

app.config.ts

export default defineAppConfig({
  repositories: {
    leads: LeadRepository,
    contacts: ContactRepository,
  },

  interceptors: {
    request: [appendSource],
    response: [errorHandler],
  },

  errorHandlers: {
    401: async ({ flash }) => navigateTo('/auth/login'),
    422: async ({ response }) => new ValidationError(response),
  },
})

Environment Variables

NUXT_PUBLIC_API_URL=https://api.example.com
NUXT_PUBLIC_KEYCLOAK_URL=https://auth.example.com
NUXT_PUBLIC_KEYCLOAK_REALM=my-realm
NUXT_PUBLIC_KEYCLOAK_CLIENT_ID=my-app
NUXT_PUBLIC_REPOSITORIES_LEADS_FETCH_OPTIONS_BASE_URL=https://leads-api.example.com