next-firebase-auth-edge

---

Next.js Firebase Authentication for Edge and Node.js runtimes. Use Firebase Authentication with latest Next.js features.


Example

Check out a working demo here: next-firebase-auth-edge-starter.vercel.app

You can find the source code for this demo at examples/next-typescript-starter

Guide

New to Firebase or Next.js? No worries! Follow this easy, step-by-step guide to set up Firebase Authentication in Next.js app using the next-firebase-auth-edge library:

https://hackernoon.com/using-firebase-authentication-with-the-latest-nextjs-features

Docs

The official documentation is available here: https://next-firebase-auth-edge-docs.vercel.app

Why?

The official firebase-admin library depends heavily on Node.js’s internal crypto library, which isn’t available in Next.js Edge Runtime.

This library solves that problem by handling the creation and verification of Custom ID Tokens using the Web Crypto API, which works in Edge runtimes.

Features

next-firebase-auth-edge supports all the latest Next.js features, like the App Router and Server Components.

To make adopting the newest Next.js features easier, this library works seamlessly with both getServerSideProps and legacy API Routes.

$3

* Supports Next.js's latest features
* Zero bundle size
* Minimal setup: Unlike other libraries, you won’t need to create your own API routes or modify your next.config.js. Everything’s handled by middleware.
* Secure: Uses jose for JWT validation, and signs user cookies with rotating keys to prevent cryptanalysis attacks.

$3

Key updates in latest release include:

* New enableTokenRefreshOnExpiredKidHeader option in authMiddleware, which refreshes user tokens when Google’s public certificates expire (instead of throwing an error)
* Added privatePaths option to redirectToLogin helper function
* Added Metadata feature that allows to store custom data inside session cookies
* Added removeServerCookies method to handle logout from inside Server Action
* Added experimental_createAnonymousUserIfUserNotFound option to create anonymous user if no user was found
* Full Firebase Emulator Support.
The library now fully supports the Firebase Emulator, enabling you to run your development app without needing to create a Firebase Project. Follow starter example README for details
* Custom token is now optional. To enable custom token support use enableCustomToken option
* Support ESM, Browser and Node.js imports for better tree-shaking features
* Support for Node.js 23 and NPM 11
* Support for Next.js 15
* Support for React 19

Installation

To install, run one of the following:

With npm

``shell
npm install next-firebase-auth-edge
`

With yarn

`shell
yarn add next-firebase-auth-edge
`

With pnpm

`shell
pnpm add next-firebase-auth-edge
``

→ Read the docs