This package contains the Next.js SDK for Ory. It provides a set of React components, server-side components, and hooks to interact with the Ory ecosystem. Supports both app and page routers.
[!NOTE]
This package's primary use case is for developing custom components for login, registration, verification, settings, recovery, or consent. For integrating authentication without changing the UI, follow our guide for Auth.js.
This package includes a middleware for the app and page router that enables
local development and preview environments to work with
Ory's cookie security model. When
using the @ory/nextjs middleware, Ory Tunnel is not needed for development.
Check the app router and page router middleware example for more details.
Run npm install @ory/nextjs or yarn add @ory/nextjs to install the package.
This middleware expects environment variable NEXT_PUBLIC_ORY_SDK_URL to be set
to your Ory Network Project SDK URL. This is the URL that you would use to
access the Ory API. If you have a custom domain for your Ory Network Project,
you should use the custom domain for NEXT_PUBLIC_ORY_SDK_URL.
See the examples directory for examples on how to use the package.
This package is built using Nx.
Run nx build @ory/nextjs to build the library.
Run nx dev @ory/nextjs to watch the source code for changes and continuously
build the library.
Run nx test @ory/nextjs to execute the unit tests via
Jest.