docs: clarify use cases and document nextjs

Author: aeneasr

README.md

@@ -22,6 +22,11 @@ Ory Elements comes with several packages:
 > before, we recommend migrating to @ory/elements-react. The legacy code base is
 > in https://github.com/ory/elements-legacy.
 
+If you're not looking to implement custom UI components for login, registration,
+settings, verification, recovery, or consent, but rather want to integrate
+authentication without changing the UI, follow our
+[guide for Auth.js](https://www.ory.sh/docs/getting-started/integrate-auth/auth-js).
+
 ## Getting Started
 
 ### React

packages/nextjs/README.md

@@ -4,16 +4,47 @@ 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.
 
+<<<<<<< Updated upstream
 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](https://www.ory.sh/docs/getting-started/integrate-auth/auth-js).
+
+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`.
+>>>>>>> Stashed changes
 
 ## Installation
 
 Run `npm install @ory/nextjs` or `yarn add @ory/nextjs` to install the package.
 
 ## Examples
 
+<<<<<<< Updated upstream
 See the [examples](../../examples) directory for examples on how to use the
 package.
+=======
+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](https://www.ory.sh/docs/security-model). When
+using the `@ory/nextjs` middleware, Ory Tunnel is not needed for development.
+
+Check the
+[app router](https://github.com/ory/elements/blob/main/examples/nextjs-app-router/middleware.ts)
+and
+[page router](https://github.com/ory/elements/blob/main/examples/nextjs-pages-router/middleware.ts)
+middleware example for more details.
+
+## Learn by example
+
+See the [examples](https://github.com/ory/elements/blob/main/examples) directory
+for examples on how to use the package.
+>>>>>>> Stashed changes
 
 ## Development