Changelog

Overview of the latest features in Nuxt Spec.

0.4.1

2026-10-29

• feat(cli): scaffold Nuxt starter project when on empty folder (#74)
• feat(cli): support all possible extensions of Nuxt Config file (#75)
• fix: missing lang attr in default app entry (#71)
• docs: updated project logo
• docs: add short project annotation to README file
• build: bump nuxt to 4.6.3
• build: pin exact playwright version to 1.64.1
• build: updated dependencies (see the overview)

0.4.0

2026-10-21

• refactor: move internal components away from app.vue
• no other changes from 0.4.0-alpha.5

0.4.0-alpha.5

2026-10-20

• feat: scaffold package.json and nuxt.config.ts in an empty project (#67)
• build: updated dependencies (see the overview)

0.4.0-alpha.4

2026-10-19

• feat: make nuxtSpecReportPlugin Vite plugin available as standalone import
• feat: add warning if Vitest project is not extending the base config
• build: bump nuxt to 4.6.2
• build: bump vitest to 5.0.5
• build: updated dependencies (see the overview)

0.4.0-alpha.3

2026-10-16

• feat: CLI scripts carved out into a separate nuxt-spec-cli package (#66)
• feat: add current version into CLI scripts output
• chore: fix variable names in CLI scripts

0.4.0-alpha.2

2026-10-13

• feat: include @nuxt/devtools v4 dependency (#63)
• feat: add support for Vitest coverage mode (#64)
• feat: add example workflows for CI/CD testing (#65)
• docs: new dedicated page for CI/CD testing workflows
• build: bump nuxt to 4.6.1
• build: bump playwright to 1.64.0
• build: updated dependencies (see the overview)

0.4.0-alpha.1

2026-10-08

• feat: (BREAKING) update to Vitest v5 (#55)
• feat: enhanced HTML reporting of all tests (#59)
• feat: more flexible configuration via nuxt.config.ts (#60)
• feat: add nuxt-spec related entries into .gitignore from CLI (#57)
• feat: unify log messages with [Nuxt Spec] prefix
• fix: wrong.png image must also be copied to sample test suite via CLI setup
• fix: avoid duplicate warning when undefined param is passed to built-in functions
• fix: incorrect pnpm setting syntax in CLI setup
• refactor: drop unnecessary key presence checks in CLI setup
• docs: move dependency bumps from changelog to separate docs page (#62)
• docs: document Vitest browser screenshots behavior (via comment in sample test file)
• docs: grammar checks and polishing
• build: bump to Nuxt v4.6
• build: updated dependencies (see the overview)

0.3.4

2026-09-12

• feat: run nuxt prepare in CLI scripts (#53)
• feat: allow passing explicit package manager to CLI scripts (#54)
• fix: add explicit allowBuilds to pnpm settings (#48)
• fix: (BREAKING) rename node Vitest project to more logical unit (#49)
• fix: expose h3-next alias resolution (#50)
• fix: declare explicit version of playwright aligned with playwright-core
• fix: correct update commands for npm and yarn
• docs: add info about trustPolicy issue (#47)
• docs: document difference between mount and mountSuspended in example test (#51)
• docs: update install instructions
• docs: fix links to GitHub issues
• build: bump pnpm to v12
• build: updated dependencies (see the overview)

0.3.3

2026-08-31

• feat: add support for external Playwright server in e2e and browser projects (#46)
• feat: add example of visual regression testing in browser mode
• docs: add file-name headers to code examples
• build: playwright version aligned across all dependencies
• build: updated dependencies (see the overview)

0.3.2

2026-08-14

• feat: add @nuxt/hints integration (#45)
• build: @nuxt/hints dependency added

0.3.1

2026-08-08

• feat: enhanced CLI setup script to handle playwright-core local setup (#44)
• feat: new CLI update script to refresh existing installation (#44)
• build: updated dependencies (see the overview)

0.3.1-alpha.2

2026-08-08

• fixed CLI script errors (JS file imports + GitHub links)

0.3.1-alpha.1

2026-08-08

• see 0.3.1

0.3.0

2026-07-28

• BREAKING CHANGE: signature changes to unify all utility methods to accept page and options param
• feat: add runtime param guards to utility methods (warn will be emitted if wrong type passed)
• feat: fine-grained control over default test.projects in loadVitestConfig function
• fix: correct compareScreenshot implementation to only update baseline images if they do not exist or a change is detected (and Vitest allows update)
• fix: adjust usage hints for Deno in CLI
• refactor: more efficient work with FS in utility methods
• docs: new standalone VitePress site at https://nuxt-spec.netlify.app/
• build: updated dependencies (see the overview)

0.3.0-alpha.3

2026-07-27

• build: update deps (Nuxt v4.5.1)

0.3.0-alpha.2

2026-07-27

• build: update deps (Nuxt v4.5)

0.3.0-alpha

2026-07-13

• see 0.3.0

0.2.4

2026-07-03

• feat: HTML report for failed visual regression tests
• feat: better validation of options passed into the compareScreenshot function
• fix: remove obsolete onlyBuiltDependencies from CLI setup (#41)
• build: non-important dependencies are now loosened to ~
• build: vue-tsc dependency added
• build: updated dependencies (see the overview)

0.2.3

2026-06-02

• feat: ability to install node_modules automatically in CLI setup (#37)
• feat: allow custom log messages filtering (#38)
• fix: creating .nuxtrc file in CLI setup to prevent @nuxt/test-utils auto-setup
• build: updated dependencies (see the overview)

0.2.2

2026-04-27

• build: updated dependencies (see the overview)

0.2.1

2026-03-30

• fix: augment existing pnpm-workspace.yaml correctly (#39)

0.2.0

2026-03-24

• no changes from 0.2.0-alpha.10

0.2.0-alpha.10

2026-03-24

• fix: correct waitUntil option in sample visual test (#33)
• fix: export nuxt.config.ts in package for proper layer resolution (#34)
• fix: filter out unnecessary warning logs on stdout along with stderr (#36)

0.2.0-alpha.9

2026-03-24

• fix: repair sample test portability to target projects (#32)

0.2.0-alpha.8

2026-03-23

• feat: alter setup from creating .npmrc to pnpm-workspace.yaml
• feat: filter out unnecessary warning logs (#30)
• refactor: re-organize /config directory

0.2.0-alpha.7

2026-03-19

• fix: proper resolution of project config overrides (#29)

0.2.0-alpha.6

2026-03-19

• feat: add pixelmatch to mitigate cross-platform rendering differences in visual tests
• build: pixelmatch and fast-png dependency added
• build: updated dependencies (see the overview)

0.2.0-alpha.5

2026-03-19

• build: updated dependencies (see the overview)
• build: security updates in transitive deps

0.2.0-alpha.4

2026-02-26

• fix: update types for nuxt-spec/utils subpackage

0.2.0-alpha.3

2026-02-26

• refactor: introduce options parameter into compareScreenshot function
• feat: enhance compareScreenshot function to support CSS selector for element-specific screenshots

0.2.0-alpha.2

2026-02-24

• fix: export nuxt-spec/utils sub-package properly
• fix: make custom defu merger function for Vitest config available in production build
• fix: corrected util function name to compareScreenshot

0.2.0-alpha.1

2026-02-23

• feat: included @vitest/browser and @vitest/ui packages
• feat: added new browser project config for Vitest browser-mode tests
• feat: introduced crude solution for visual regression testing (#2)
• feat: introduced compareScreenshot util function for visual regression testing
• feat: introduced gotoPage, getDataHtml and getAPIResultHtml helpers for Nuxt E2E tests (#27)
• fix: created proper custom merging strategy for test.projects config (#24)
• docs: explained latest changes in README.md
• build: @vitest/browser-playwright, @vitest/ui, @vitejs/plugin-vue and vitest-browser-vue dependency added
• build: updated dependencies (see the overview)

0.1.18

2026-02-08

• feat: update default config to support sub-directories (#26)
• build: updated dependencies (see the overview)

0.1.17

2026-01-12

• build: updated dependencies (see the overview)

0.1.16

2025-12-14

• fix: corrected typing for loadVitestConfig function (#23)
• fix: native support for #components alias in test/nuxt folder via Nuxt 4.2.2 (#17)
• build: updated dependencies (see the overview)

0.1.15

2025-11-06

• fix: add TS support for Nuxt aliases like #components in test files (#17)
• docs: added info about passing Vite config into loadVitestConfig
• build: updated dependencies (see the overview)

0.1.14

2025-10-27

• fix: proper error handling in CLI (#20)
• fix: loading vitest config during runtime (#21)

0.1.13

2025-10-26

• feat: TS types in nuxt-spec/config (#18)
• feat: option to exclude projects from vitest config (#19)
• build: updated dependencies (see the overview)

0.1.12

2025-10-16

• fix: allow proper extending from Nuxt Spec layer again (#16)
• fix: update component import in Nuxt component test file (#15)
• build: bump happy-dom to 20.0.2 (fix CVE-2025-62410)

0.1.11

2025-10-15

• feat: CLI scripts can scaffold sample test files (#8)
• feat: CLI script also removes deno.lock file if present (#13)
• feat: CLI scripts only set shamefully-hoist=true for pnpm (#14)
• feat: GitHub links now use specific version tags

0.1.10

2025-10-10

• feat: CLI script now try-catches each step and will finish even if errors are encountered
• feat: CLI script now accepts external autoRun parameter to avoid even the initial prompt
• feat: CLI script now guesses executing package manager to give more accurate usage hints
• feat: CLI script now scaffolds "pnpm": "onlyBuiltDependencies" if pnpm is used
• refactor: merge "auto" and "manual" CLI scripts to avoid duplication
• test: small updates in demo suite
• docs: instructions for more package managers
• build: updated dependencies (see the overview)

0.1.9

2025-10-05

• feat: improved CLI setup - removing dependencies (nuxt, vue, vue-router) from package.json
• feat: improved CLI setup - removing node_modules and lock file(s)
• feat: change CLI execution - now runs via npx nuxt-spec setup
• build: bump vitest to 4.0.0-beta.16, happy-dom to 19.0.2, playwright-core to 1.55.1 and typescript to 5.9.3

0.1.8

2025-09-18

• feat: improved CLI tooling with elrh-cosca - run npx nuxt-spec to start the setup wizard
• feat: "auto" and "manual" CLI mode
• docs: updated README with new setup instructions
• build: bump Nuxt to 4.1.2, Vitest to 4.0.0-beta.11 + few other deps
• chore: improved release process - run tests before building and build before publishing

0.1.7

2025-08-24

• fix: update elrh-cosca to solve module resolution issue (experimental)

0.1.6

2025-08-24

• feat: delegate code-scaffolding tasks to new elrh-cosca library (experimental)

0.1.5

2025-08-16

• fix: invalid Vitest config + broken import path (#4)
• build: bump Vitest

0.1.4

2025-08-16

• fix: make loadVitestConfig available from root dir - solving issues from testing (#4)

0.1.3

2025-08-16

• fix: make loadVitestConfig available from root dir (#4)

0.1.2

2025-08-09

• fix: target path for scaffolded vitest.config.ts (#3)

0.1.1

2025-08-09

• feat: CLI tool for scaffolding vitest.config.ts and test-related scripts in package.json
• docs: added CHANGELOG.md and fixed link to playwright-core

0.1.0

2025-08-08

• initial release v0.1.0
• key features:
  • Nuxt base layer for testing
  • Nuxt v4 and Vitest v4 compatibility
  • Integrated vitest, @vitest/browser, happy-dom, playwright-core, @vue/test-utils, @nuxt/test-utils
  • Support for custom configuration via loadVitestConfig function in vitest.config.ts