Releases: sidebase/nuxt-auth
0.6.0-beta.6
What's Changed
- feat: protected route redirect overwrite per page by @LouisHaftmann in #424
- feat: getSession force refetch option by @LouisHaftmann in #425
- fix: Abort SSR rendering on redirect by @NielsJanssen in #438
- release: 0.6.0-beta.6 by @zoey-kaiser in #534
New Contributors
- @NielsJanssen made their first contribution in #438
Full Changelog: 0.6.0-beta.5...0.6.0-beta.6
0.6.0-beta.5
This is a small release, which fixes an issue with the session already being fetched during nitro prerender. This would cause issues in the application.
What's Changed
- lint: fix: Don't fetch session during nitro prerender by @genu in #521
- release: 0.6.0-beta.5 by @zoey-kaiser in #522
New Contributors
Full Changelog: 0.6.0-beta.4...0.6.0-beta.5
0.6.0-beta.4
What's Changed
- Update 4.custom-session-data.md by @asokr in #458
- docs(fix): dead links by @BracketJohn in #460
- Adds cookie sameSite attribute to config in Local provider by @bmhtech07 in #505
- release: 0.6.0-beta.4 by @zoey-kaiser in #511
New Contributors
- @asokr made their first contribution in #458
- @bmhtech07 made their first contribution in #505
Full Changelog: 0.6.0-beta.3...0.6.0-beta.4
0.6.0-beta.3
What's Changed
- fix: definePageMeta auth option type by @mlutsiuk in #398
- fix: Fixed Docus runnable locally, outside of
docs/repo by @zoey-kaiser in #406 - hotfix: Fixed aisde level for 0.6 docs by @zoey-kaiser in #408
- docs: Made NextAuth Link to NextAuthHandler more visable by @zoey-kaiser in #440
- fix: accept boolean value for
globalAppMiddlewareoption by @LouisHaftmann in #423 - Fix issue with getToken function and using raw: true in options. by @csprance in #434
- fix: runtimeConfig
authkey access by @mlutsiuk in #414 - fix(docs): typo by @Hrdtr in #416
- release: 0.6.0-beta.3 by @BracketJohn in #459
New Contributors
- @LouisHaftmann made their first contribution in #423
- @csprance made their first contribution in #434
- @Hrdtr made their first contribution in #416
Full Changelog: 0.6.0-beta.2...0.6.0-beta.3
0.6.0-beta.2
What's Changed
- fix: runtimeConfig access 'auth' property on top level warning by @mlutsiuk in #381
- docs: improve v0.6 session acccess and management by @BracketJohn in #391
- fix: middleware, status was always 'loading', if no session was set by @Danielwinkelmann in #393
- release: 0.6.0-beta.2 by @BracketJohn in #394
Full Changelog: 0.6.0-beta.1...0.6.0-beta.2
0.6.0-beta.1
What's Changed
- Fix mispellings of "immediately". by @KyleSmith0905 in #377
- Make HTTP vs HTTPS port default clear by @drusellers in #353
- fix: #356 - Extend/change local signIn credentials type by @Danielwinkelmann in #375
- fix: Improve typing of sessiondata by @Danielwinkelmann in #376
- fix: Autocomplete for 'auth' middleware in definePageMeta by @mlutsiuk in #379
- release: 0.6.0-beta.1 by @BracketJohn in #380
New Contributors
- @KyleSmith0905 made their first contribution in #377
- @drusellers made their first contribution in #353
- @Danielwinkelmann made their first contribution in #375
- @mlutsiuk made their first contribution in #379
Full Changelog: 0.6.0-beta.0...0.6.0-beta.1
0.6.0-beta.0
What's Changed
- avoided calling getSession endpoint when token is absent by @tnt-freskim-veliu in #355
- fix: await for the joinPathToApiURLWN of signinUrl on authjs / useAuth / signIn() / (#359) by @guesant in #360
- release: 0.6.0-beta.0 by @BracketJohn in #362
New Contributors
- @tnt-freskim-veliu made their first contribution in #355
- @guesant made their first contribution in #360
Full Changelog: 0.6.0-alpha.2...0.6.0-beta.0
0.6.0-alpha.2
What's Changed
- docs: add azure AD example by @thomasfjordside in #332
- Improve v0.6. local provider: correctly bundle types into final package, unset token when getsession fails and more by @BracketJohn in #347
- improves directory structure for testing and development
- local playground
- authjs playground
- fix: not all properties of
localprovider are required any longer - fix: move types into runtime so that final
distgets correct types - fix: unset token on unsuccessful session fetch
- fix: also send auth headers on signout
- improves directory structure for testing and development
- release: 0.6.0-alpha.2 by @BracketJohn in #348
New Contributors
- @thomasfjordside made their first contribution in #332
Full Changelog: 0.6.0-alpha.1...0.6.0-alpha.2
0.6.0-alpha.1
🔐 nuxt-auth is an authentication package for Nuxt 3. It provides oauth sign-in, credential sign-in and magic-email sign-in flows. Read more: https://sidebase.io/nuxt-auth/v0.6/getting-started
This is a pre-release of v0.6.0 of the nuxt-auth module. Notably, it introduces:
- static Nuxt 3 app support
localprovider support- multi-provider support to facilitate the above -> extensible for future providers
- new and improved docs
To use the new version follow the installation instructions. Here's a small spoiler of what the new module has in store:

🙏 Please help test & stabilize this version - need to run a static Nuxt 3 app? Need a simple local provider? That would be a great test-case for this module 🙏
Note: This is still an early version, it will still be rough and is not production ready. Liberally file issues for this version or contact us on discord (https://discord.gg/NDDgQkcv3s)
Example: Provider authjs
This is what <= v0.5 used as the only possible provider.
export default defineNuxtConfig({
modules: ['@sidebase/nuxt-auth'],
auth: {
provider: {
type: 'authjs'
}
}
})Example: Provider local
This is the new provider that supports static username + password flows. Static OAuth is not yet supported.
export default defineNuxtConfig({
modules: ['@sidebase/nuxt-auth'],
auth: {
provider: {
type: 'local'
}
}
})Breaking changes?
There's a few breaking changes in comparison to v0.5.0 of the module. If you are used to v0.5 or below the biggest change will be:
- the module-config-structure.
- using
authjsto identifynext-auth
More Info?
For more checkout:
What's Changed
- Docs: improve guest mode example by @KoenCa in #327
- Add initial multi-provider support - supported: authjs + local providers by @BracketJohn in #317
- release: 0.6.0-alpha.0 by @BracketJohn in #328
- fix: imports not beyong runtime level by @BracketJohn in #329
- fix(docs): all links now point to v0.6 and not 0.6 by @BracketJohn in #330
- release: 0.6.0-alpha.1 by @BracketJohn in #331
New Contributors
Full Changelog: 0.5.0...0.6.0-alpha.1
0.5.0
🔐 nuxt-auth is an authentication package for Nuxt 3. It provides oauth sign-in, credential sign-in and magic-email sign-in flows. Read more: https://sidebase.io/nuxt-auth/getting-started
This is the minor release 0.5.0. It contains breaking changes. To use the new version follow the installation instructions:
# install the new release of `nuxt-auth`
npm i -D @sidebase/[email protected]
# install `next-auth` as a peer-dependency if you haven't already done so
npm i [email protected]Whats changed
🚨 Breaking change: useSession was renamed to useAuth
The useSession composable is deprecated. useSession is now called useAuth:
const { status } = useAuth()To upgrade:
- install the latest module version
- replace all
useSessioncomposable calls withuseAuth - Clean the nuxt cache (
rm -r .nuxt) so that it correctly picks up the renaming - Run
npm run devand you are good to go
Feature: Guest Mode
You can now use guest mode on your pages:
// file: ~/pages/login.vue
definePageMeta({
auth: {
unauthenticatedOnly: true,
navigateAuthenticatedTo: '/profile'
}
})This will only allow unauthenticated "guests" to visit the /login page and redirect all other users to /profile instead. Full docs here: https://sidebase.io/nuxt-auth/application-side/guest-mode
All changes
- Docs: Fix broken glossary links by @pascalwengerter in #285
- feat: Rename to use useAuth, upgrade deps by @BracketJohn in #302
- Add guest mode by @BracketJohn in #304
- feat: switch to pnpm for development by @BracketJohn in #305
- release: 0.5.0-rc.0 by @BracketJohn in #306
- docs: revert to useSession, add info about useAuth by @lookto in #318
- fix: Correct typos fixed by @initred in #323
- docs: change official name from useSession to useAuth in docs, keep disclaimers for <=0.5 users by @BracketJohn in #325
- release: 0.5.0 by @BracketJohn in #326
New Contributors
- @pascalwengerter made their first contribution in #285
- @lookto made their first contribution in #318
- @initred made their first contribution in #323
Full Changelog: 0.4.4...0.5.0