# Nuxt Config

> 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.

- Skill: `majiayu000/nuxt-config` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/nuxt-config`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/nuxt-config/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/nuxt-config

---


# Nuxt Configuration

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

## Core Concepts

**[config.md](references/config.md)** - Complete configuration patterns

## nuxt.config.ts

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

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

  modules: ['nuxt-auth-sanctum', '@nuxt/ui'],

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

  sanctum: {
    baseUrl: process.env.NUXT_PUBLIC_API_URL,
    endpoints: { login: '/auth/login', user: '/auth/user' },
  },

  runtimeConfig: {
    public: {
      apiUrl: undefined,  // Set via NUXT_PUBLIC_API_URL
    },
  },
})
```

## app.config.ts

```typescript
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

```bash
NUXT_PUBLIC_API_URL=https://api.example.com
NUXT_PUBLIC_REPOSITORIES_LEADS_FETCH_OPTIONS_BASE_URL=https://leads-api.example.com
```