jsschools

useAppConfig()

Accesses build-time, reactive app configuration defined in app.config.ts.

Since Nuxt 3.0 Spec ↗

Syntax

const appConfig = useAppConfig()

Returns

AppConfig — The merged, reactive app config object.

Examples

// app.config.ts
export default defineAppConfig({
  theme: { primary: '#3b82f6' },
  title: 'My App',
})

<script setup lang="ts">
const appConfig = useAppConfig()
const primary = appConfig.theme.primary
</script>

Notes

Unlike `runtimeConfig`, `app.config` is determined at build time and bundled into the client — never put secrets here. It is reactive and ideal for theming, feature toggles, and values modules want to expose and extend. Cannot be overridden by environment variables.

See also