@ory/nextjs
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.
Use case
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.
Installation
Run npm install @ory/nextjs or yarn add @ory/nextjs to install the package.
Configuration
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.
Learn by example
See the examples directory for examples on how to use the package.
Development
This package is built using Nx.
Building
Run nx build @ory/nextjs to build the library.
Developing
Run nx dev @ory/nextjs to watch the source code for changes and continuously
build the library.
Running unit tests
Run nx test @ory/nextjs to execute the unit tests via
Jest.