@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.