🔗 Linked issue

resolves nuxt/nuxt#11406, resolves nuxt/nuxt#12612, resolves nuxt/nuxt#12675, resolves nuxt/nuxt#12652, resolves nuxt/nuxt#12922, resolves nuxt/nuxt#12892, resolves nuxt/nuxt#13098

Related: nuxt/bridge#223 (will fix in follow-up PR)

Previous PRs

closes #2249, closes #2262

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

This PR refactors how we configure the base path of an application (previously router.base), the build assets path (previously build.publicPath) and any CDN URL.

export default defineNuxtConfig({
  build: {
    publicPath: '/_nuxt' // now app.buildAssetsPath
  },
  router: {
    base: '/' // now app.basePath
  },
  app: {
    base: '/',
    buildAssetsPath: '/_nuxt/',
    // optionally
    // cdnURL: 'https://mycdn.org/' 
  }
})

It also implements dynamic configuration for BASE_PATH and CDN_URL (which must end with /):

BASE_PATH=/foo/ CDN_URL=https://mycdn.org/ node .output/server/index.mjs

If there are static assets (such as images in the ~/public folder) which should be updated to the dynamically configured path, these should be indicated by using a 'magic' string:

<template>
  <img src="/__NUXT_BASE__/logo.svg" alt="My logo loaded from a dynamic base path.">
</template>

Note: With nuxt/nuxt#10197, this PR also adds dynamic router base + CDN support for Nuxt Bridge (with the exception of the static file 'dynamic' prefix with /__NUXT_BASE__/ which only applies to Nuxt 3).

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.