README.md

@ory/nextjs

This package contains the Next.js SDK for Ory. It is additive to the @ory/elements-react package and provides utility functions for the app and page router.

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.

Installation

Run npm install @ory/nextjs or yarn add @ory/nextjs to install the package.

Next.js middleware for local development and preview deployments

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.

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.