@uxfront/layer-app

A neutral, brandable Nuxt layer application shell. Extend it, supply your own branding and pages, and get the uxfront app backbone — SEO, site metadata, OG images, analytics, i18n routing and neutral Nuxt UI polish — without copying boilerplate between repos.

The layer ships no product branding. Consuming apps provide title, logos, socials, GitHub, footer and colour palette via their own app.config.ts, merged over the layer's neutral defaults by Nuxt's defu layer merge. Site metadata, SEO and git info are auto-inferred from the consumer's package.json + git when not supplied.

Authentication (@nuxtjs/supabase) is intentionally not wired in this layer — it is a consumer concern that requires provisioned project credentials.

Install

npm install -D @uxfront/layer-app

Then install the peer dependencies the layer expects (the Nuxt app stack — see package.json peerDependencies for pinned ranges): nuxt, vue, @nuxt/ui, @nuxt/image, @nuxt/scripts, @nuxtjs/robots, nuxt-og-image, nuxt-llms, tailwindcss, and — for translation — @nuxtjs/i18n.

Usage

Extend the layer from your app's nuxt.config.ts:

export default defineNuxtConfig({
  extends: ["@uxfront/layer-app"],
});

Supply your branding from your app's app.config.ts:

export default defineAppConfig({
  header: { title: "My App" },
  // logos, socials, footer, ui.colors …
});

Compatibility

Pinned to the Nuxt 4 app stack (Nuxt 4.4, Nuxt UI 4.8, og-image 6, llms 0.2). TypeScript is pinned to the range the Nuxt stack supports (^6.0.3). See peerDependencies for the authoritative ranges.

License

MIT