release: v0.5.3

AloisSeckar · AloisSeckar · commit 29761c677a82 · 2026-01-03T19:12:40.000+01:00
diff --git a/core/bin/set-app-vue.js b/core/bin/set-app-vue.js
@@ -11,7 +11,7 @@ import { createFileFromWebTemplate } from 'elrh-cosca'
  */
 export async function setAppVue() {
   try {
-    await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.2/core/app/app.vue', 'app/app.vue')
+    await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.3/core/app/app.vue', 'app/app.vue')
   } catch (error) {
     console.error('Error creating Ignis `app.vue` file:\n', error.message)
   }
diff --git a/core/bin/set-css.js b/core/bin/set-css.js
@@ -11,7 +11,7 @@ import { createFileFromWebTemplate } from 'elrh-cosca'
  */
 export async function setCSS() {
   try {
-    await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.2/core/app/assets/css/ignis.css', 'app/assets/css/ignis.css')
+    await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.3/core/app/assets/css/ignis.css', 'app/assets/css/ignis.css')
   } catch (error) {
     console.error('Error creating Ignis CSS file:\n', error.message)
   }
diff --git a/core/bin/set-eslint.js b/core/bin/set-eslint.js
@@ -9,7 +9,7 @@ import { createFileFromWebTemplate } from 'elrh-cosca'
  */
 export async function setESLint() {
   try {
-    await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.2/core/eslint.config.mjs', 'eslint.config.mjs')
+    await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.3/core/eslint.config.mjs', 'eslint.config.mjs')
   } catch (error) {
     console.error('Error creating ESLint config file:\n', error.message)
   }
diff --git a/core/bin/setup.js b/core/bin/setup.js
@@ -33,7 +33,7 @@ export async function nuxtIgnisSetup(autoRun = false) {
 
   // 1.1 - add nuxt-ignis dependency
   try {
-    await updateJsonFile('package.json', 'dependencies', { 'nuxt-ignis': '0.5.2' },
+    await updateJsonFile('package.json', 'dependencies', { 'nuxt-ignis': '0.5.3' },
       isAutoRun, 'This will add \'nuxt-ignis\' dependency to your \'package.json\'. Proceed?')
   } catch (error) {
     console.error('Error adding \'nuxt-ignis\' dependency:\n', error.message)
@@ -135,7 +135,7 @@ export async function nuxtIgnisSetup(autoRun = false) {
         await updateTextFile('.npmrc', ['shamefully-hoist=true'], isAutoRun,
           'This will adjust \'.npmrc\' file in your project. Continue?')
       } else {
-        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.2/core/.npmrc',
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.3/core/.npmrc',
           '.npmrc', isAutoRun, 'This will add \'.npmrc\' file for your project. Continue?')
       }
     } catch (error) {
diff --git a/core/package.json b/core/package.json
@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ignis",
   "description": "A ready-to-use setup for your next application in Nuxt",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "config": {
     "date": "2025-11-20"
   },
diff --git a/docs/1-4-installation.md b/docs/1-4-installation.md
@@ -39,7 +39,7 @@ The CLI command will perform following steps. You can also do them manually if y
 ```json [package.json]
 {
   "dependencies": {
-    "nuxt-ignis": "0.5.2"
+    "nuxt-ignis": "0.5.3"
   }
 }
 ```
diff --git a/docs/2-1-configuration.md b/docs/2-1-configuration.md
@@ -10,7 +10,7 @@ The "magic" is done via environment variables, which you can set in your `.env`
 
 The very nature of the process requires `nuxt.config.ts` to be static. The bundler must get a snapshot of its current state and construct the output based on it. However, this doesn't mean you have to hardcode everything in it. The build process itself runs in Node.js (or other JS runtime) and thanks to that, environment variables are available via `process.env` object.
 
-Nuxt Ignis emerged from embracing this fact. Provided environment variables are processed in [`setFeatures()` function](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/features.ts) which happens to return a Nuxt config-like object. The output of this function is then merged into the final `nuxt.config.ts` file. This happens before the build step is executed, so the environment variables apply as intended.
+Nuxt Ignis emerged from embracing this fact. Provided environment variables are processed in [`setFeatures()` function](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/features.ts) which happens to return a Nuxt config-like object. The output of this function is then merged into the final `nuxt.config.ts` file. This happens before the build step is executed, so the environment variables apply as intended.
 
 The typical application is to include or exclude certain Nuxt module. For example Nuxt Ignis is including [`@nuxt/eslint`](https://nuxt.com/modules/eslint) into `module` array of the config object, but if the feature function sees `NUXT_PUBLIC_IGNIS_CORE_ESLINT=false` environment variable, it will omit it. Some config options also imply other modifications in the config object, but the idea remains the same.
 
@@ -28,7 +28,7 @@ This principle is addressed as _"defu-merge"_ throughout the docs and in source
 
 All existing config options are also defined as [public runtime config values](https://nuxt.com/docs/guide/directory-structure/nuxt.config#runtime-config) in a standard Nuxt fashion - i.e. `NUXT_PUBLIC_IGNIS_SSR` can be accessed as `useRuntimeConfig().public.ignis.ssr`. While this doesn't affect the build process itself, it can be used for runtime checks if certain feature is enabled or not.
 
-There are several examples of such usage in Nuxt Ignis codebase, starting in [`app.vue` file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/app.vue).
+There are several examples of such usage in Nuxt Ignis codebase, starting in [`app.vue` file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/app.vue).
 
 ## More info
 
diff --git a/docs/3-11-features-built-ins.md b/docs/3-11-features-built-ins.md
@@ -6,7 +6,7 @@ Nuxt Ignis contains couple of built-in pages and components, that will become a
 
 Nuxt Ignis provides a default `app/app.vue` file, that contains basic layout of Nuxt application. The file contains logic for having both `Nuxt UI` and `non-Nuxt UI` mode and also to use or not to use `pages` support. It also includes `<NuxtRouteAnnouncer>` component for better accessibility.
 
-You can check the implementation details [HERE](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/app.vue).
+You can check the implementation details [HERE](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/app.vue).
 
 If you need something else, you can overwrite it with your own file in the target project as you see fit. If you want to start with the default and tweak it just a little, you can use the CLI tool to [scaffold the default file](/3-12-features-cli.html#set-app-vue) into your project.
 
diff --git a/docs/3-12-features-cli.md b/docs/3-12-features-cli.md
@@ -69,7 +69,7 @@ $ deno run --allow-run npm:npx nuxt-ignis set-app-vue
 ```
 :::
 
-The file will be created as `app/app.vue` and will be equal to the [Nuxt Ignis default](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/app.vue).
+The file will be created as `app/app.vue` and will be equal to the [Nuxt Ignis default](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/app.vue).
 
 ### set-css
 
@@ -97,7 +97,7 @@ $ deno run --allow-run npm:npx nuxt-ignis set-css
 ```
 :::
 
-The file will be created as `app/assets/css/ignis.css` and will be equal to the [Nuxt Ignis default](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/assets/css/ignis.css).
+The file will be created as `app/assets/css/ignis.css` and will be equal to the [Nuxt Ignis default](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/assets/css/ignis.css).
 
 **NOTE:** If `NUXT_IGNIS_COPRENUXT_PUBLIC_IGNIS_CORE_CSS` is set to `false`, this file is **NOT** included in the project automatially. You either need to re-enable it or [set it manually](https://nuxt.com/docs/4.x/api/nuxt-config#css).
 
@@ -127,4 +127,4 @@ $ deno run --allow-run npm:npx nuxt-ignis set-eslint
 ```
 :::
 
-The file will be created as `eslint.config.mjs` and will be equal to the [Nuxt Ignis default](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/eslint.config.mjs).
+The file will be created as `eslint.config.mjs` and will be equal to the [Nuxt Ignis default](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/eslint.config.mjs).
diff --git a/docs/3-2-features-ui.md b/docs/3-2-features-ui.md
@@ -3,7 +3,7 @@
 Nuxt Ignis contains following customizable UI related features:
 
 ## Default CSS file
-There is a default CSS file [`ignis.css`](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/assets/css/ignis.css) that is included in the project by default. It contains basic styling for the HTML apps based on good practices and recommendations.
+There is a default CSS file [`ignis.css`](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/assets/css/ignis.css) that is included in the project by default. It contains basic styling for the HTML apps based on good practices and recommendations.
 
 You can disable its inclusion by setting the following environment variable:
 
diff --git a/docs/3-4-features-forms.md b/docs/3-4-features-forms.md
@@ -32,7 +32,7 @@ export default loadVueformConfig({
 })
 ```
 
-This will reference [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/utils/config/vueform.ts) to inject `Vueform` into your project. The extra step is required as it seems not possible to transfer the config file from the layer.
+This will reference [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/utils/config/vueform.ts) to inject `Vueform` into your project. The extra step is required as it seems not possible to transfer the config file from the layer.
 
 Referencing config like this allows to pass in a custom config that will be [defu-merged](/2-1-configuration.html#defu-merge) with the defaults provided by Nuxt Ignis. Alternatively, you can ignore Nuxt Ignis' default config and create your own file based on [Vueform docs](https://vueform.com/docs/installation#manual-installation) (check instructions for Nuxt).
 
@@ -68,11 +68,11 @@ const config = loadFormkitConfig({
 export default config
 ```
 
-This will reference [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/utils/config/formkit.ts) to inject `Formkit` into your project. The extra step is required as it seems not possible to transfer the config file from the layer. Note that `export default config` is a required syntax as `Formkit` expects such export in `formkit.config.ts` file.
+This will reference [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/utils/config/formkit.ts) to inject `Formkit` into your project. The extra step is required as it seems not possible to transfer the config file from the layer. Note that `export default config` is a required syntax as `Formkit` expects such export in `formkit.config.ts` file.
 
 Referencing config like this allows to pass in a custom config that will be [defu-merged](/2-1-configuration.html#defu-merge) with the defaults provided by Nuxt Ignis. Alternatively, you can provide your own config file (see [Additional options](#additional-options)) ignore Nuxt Ignis' default config and create your own file based on [Formkit docs](https://formkit.com/getting-started/installation) (check instructions for Nuxt).
 
 ### Additional options
 
 - you can select default language locale via `NUXT_PUBLIC_IGNIS_FORMKIT_LOCALE`
-- if [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/utils/config/formkit.ts) is not suitable for your project, you may specify path to your own using `NUXT_PUBLIC_IGNIS_FORMKIT_CONFIG`
+- if [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/utils/config/formkit.ts) is not suitable for your project, you may specify path to your own using `NUXT_PUBLIC_IGNIS_FORMKIT_CONFIG`
diff --git a/docs/3-6-features-content.md b/docs/3-6-features-content.md
@@ -37,7 +37,7 @@ export default loadContentConfig({
 })
 ```
 
-This will reference [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/utils/config/content.ts) to enable default `@nuxt-content` collection in your project. The extra step is required as it seems not possible to transfer the config file from the layer.
+This will reference [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/utils/config/content.ts) to enable default `@nuxt-content` collection in your project. The extra step is required as it seems not possible to transfer the config file from the layer.
 
 Referencing config like this allows to pass in a custom config that will be [defu-merged](/2-1-configuration.html#defu-merge) with the defaults provided by Nuxt Ignis. Alternatively, you can completely ignore Nuxt Ignis' default config and create your own file based on [Nuxt Content docs](https://content.nuxt.com/docs/getting-started/installation#create-your-first-collection).
 
@@ -61,7 +61,7 @@ NUXT_PUBLIC_IGNIS_I18N_ENABLED=true
 
 - All `.json` files with messages in `@/i18n/locales` folder will be auto-scanned.
 - You can select default language locale via `NUXT_PUBLIC_IGNIS_I18N_LOCALE`.
-- If [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/i18n/i18n.config.ts) is not suitable for your project, you may specify path to your own using `NUXT_PUBLIC_IGNIS_I18N_CONFIG`.
+- If [default config file](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/i18n/i18n.config.ts) is not suitable for your project, you may specify path to your own using `NUXT_PUBLIC_IGNIS_I18N_CONFIG`.
 
 ### Additional utils
 
diff --git a/docs/3-9-features-devex.md b/docs/3-9-features-devex.md
@@ -78,7 +78,7 @@ const formattedDate = format(new Date(), formatString)
 
 ## Error handling
 
-By default, Nuxt Ignis registers global Vue [error](https://vuejs.org/api/application.html#app-config-errorhandler) and [warn](https://vuejs.org/api/application.html#app-config-warnhandler) handler to process errors and warnings in your app. The error/warn object is sent to `consola` error/warn function. Additional info provided by Vue is also captured in debug mode. Check the [implementation](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.2/core/app/plugins/errorHandler.ts).
+By default, Nuxt Ignis registers global Vue [error](https://vuejs.org/api/application.html#app-config-errorhandler) and [warn](https://vuejs.org/api/application.html#app-config-warnhandler) handler to process errors and warnings in your app. The error/warn object is sent to `consola` error/warn function. Additional info provided by Vue is also captured in debug mode. Check the [implementation](https://github.com/AloisSeckar/nuxt-ignis/blob/v0.5.3/core/app/plugins/errorHandler.ts).
 
 If you don't want to rely on the default behavior, you can disable those handlers by setting `NUXT_PUBLIC_IGNIS_ERROR` to `false`.
 
diff --git a/docs/4-1-changelog.md b/docs/4-1-changelog.md
@@ -2,6 +2,17 @@
 
 Overview of the newest features in Nuxt Ignis.
 
+## 0.5.3
+
+`2026-01-03`
+
+- BREAKING: bump `nuxt-neon` to `v8` for security reasons (see [new docs](https://nuxt-neon.netlify.app/))
+- docs: fix two broken links
+- build: bump `Nuxt` to `4.2.2` and `Vue` to `3.5.26` 
+- build: switch to `Vite v8`
+- build: harden `pnpm` security settings ([#146](https://github.com/AloisSeckar/nuxt-ignis/issues/146)) ([#147](https://github.com/AloisSeckar/nuxt-ignis/issues/147))
+- chore: revised ESLint config for the project
+
 ## 0.5.2
 
 `2025-11-28`
@@ -10,14 +21,14 @@ Overview of the newest features in Nuxt Ignis.
 - feat: bump `Nuxt UI` to v4
 - feat: bump `@nuxt/image` to v2
 - build: bump `Nuxt` to `4.2.1`
-- build: bump Valibot to 1.2.0 (solve CVE-2025-66020)
-- chore: introduced pnpm catalog for easier dependency management (#129)
+- build: bump `Valibot` to `1.2.0` (solve CVE-2025-66020)
+- chore: introduced pnpm catalog for easier dependency management ([#129](https://github.com/AloisSeckar/nuxt-ignis/issues/129))
 
 ## 0.5.1
 
 `2025-10-31`
 
-- fix: workaround for Nuxt `v4.2.0` issue with some ESM modules ([#135](https://github.com/AloisSeckar/nuxt-ignis/issues/135))
+- fix: workaround for Nuxt `4.2.0` issue with some ESM modules ([#135](https://github.com/AloisSeckar/nuxt-ignis/issues/135))
 - fix: corrected linked version tags in CLI scripts
 - docs: add usage notice of `better-sqlite3` for `Nuxt Content` ([#55](https://github.com/AloisSeckar/nuxt-ignis/issues/55))
 - docs: add notice about default `app.vue` for projects scaffolded from Nuxt template ([#133](https://github.com/AloisSeckar/nuxt-ignis/issues/133))

Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,7 @@ import { createFileFromWebTemplate } from 'elrh-cosca'`
`11`	`11`	`*/`
`12`	`12`	`export async function setAppVue() {`
`13`	`13`	`try {`
`14`		`- await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.2/core/app/app.vue', 'app/app.vue')`
	`14`	`+ await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.3/core/app/app.vue', 'app/app.vue')`
`15`	`15`	`} catch (error) {`
`16`	`16`	console.error('Error creating Ignis `app.vue` file:\n', error.message)
`17`	`17`	`}`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ import { createFileFromWebTemplate } from 'elrh-cosca'`
`9`	`9`	`*/`
`10`	`10`	`export async function setESLint() {`
`11`	`11`	`try {`
`12`		`- await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.2/core/eslint.config.mjs', 'eslint.config.mjs')`
	`12`	`+ await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.3/core/eslint.config.mjs', 'eslint.config.mjs')`
`13`	`13`	`} catch (error) {`
`14`	`14`	`console.error('Error creating ESLint config file:\n', error.message)`
`15`	`15`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "nuxt-ignis",`
`3`	`3`	`"description": "A ready-to-use setup for your next application in Nuxt",`
`4`		`- "version": "0.5.2",`
	`4`	`+ "version": "0.5.3",`
`5`	`5`	`"config": {`
`6`	`6`	`"date": "2025-11-20"`
`7`	`7`	`},`
Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,7 @@ The CLI command will perform following steps. You can also do them manually if y`
`39`	`39`	```json [package.json]
`40`	`40`	`{`
`41`	`41`	`"dependencies": {`
`42`		`- "nuxt-ignis": "0.5.2"`
	`42`	`+ "nuxt-ignis": "0.5.3"`
`43`	`43`	`}`
`44`	`44`	`}`
`45`	`45`	```