diff --git a/README.md b/README.md
index 9f4dcb9a..b9855720 100644
--- a/README.md
+++ b/README.md
@@ -142,6 +142,23 @@ The second option is through the query parameters to the `/auth/login` endpoint
Login
```
+## The `returnTo` parameter
+
+### Redirecting the user after authentication
+
+The `returnTo` parameter can be appended to the login to specify where you would like to redirect the user after they have completed their authentication and have returned to your application.
+
+For example: `/auth/login?returnTo=/dashboard` would redirect the user to the `/dashboard` route after they have authenticated.
+
+### Redirecting the user after logging out
+
+The `returnTo` parameter can be appended to the logout to specify where you would like to redirect the user after they have logged out.
+
+For example: `/auth/login?returnTo=https://example.com/some-page` would redirect the user to the `https://example.com/some-page` URL after they have logged out.
+
+> [!NOTE]
+> The URLs specified as `returnTo` parameters must be registered in your client's **Allowed Logout URLs**.
+
## Accessing the authenticated user
### In the browser
@@ -405,6 +422,35 @@ To use Back-Channel Logout, you will need to provide a session store implementat
A `LogoutToken` object will be passed as the parameter to `deleteByLogoutToken` which will contain either a `sid` claim, a `sub` claim, or both.
+## Combining middleware
+
+By default, the middleware does not protect any pages. It is used to mount the authentication routes and provide the necessary functionality for rolling sessions.
+
+You can combine multiple middleware, like so:
+
+```ts
+export async function middleware(request: NextRequest) {
+ const authResponse = await auth0.middleware(request)
+
+ // if path starts with /auth, let the auth middleware handle it
+ if (request.nextUrl.pathname.startsWith("/auth")) {
+ return authResponse
+ }
+
+ // call any other middleware here
+ const someOtherResponse = await someOtherMiddleware(request)
+
+ // add any headers from the auth middleware to the response
+ for (const [key, value] of authResponse.headers) {
+ someOtherResponse.headers.set(key, value)
+ }
+
+ return someOtherResponse
+}
+```
+
+For a complete example using `next-intl` middleware, please see the `examples/` directory of this repository.
+
## Routes
The SDK mounts 6 routes:
diff --git a/examples/with-next-intl/.eslintrc.json b/examples/with-next-intl/.eslintrc.json
new file mode 100644
index 00000000..37224185
--- /dev/null
+++ b/examples/with-next-intl/.eslintrc.json
@@ -0,0 +1,3 @@
+{
+ "extends": ["next/core-web-vitals", "next/typescript"]
+}
diff --git a/examples/with-next-intl/.gitignore b/examples/with-next-intl/.gitignore
new file mode 100644
index 00000000..d32cc78b
--- /dev/null
+++ b/examples/with-next-intl/.gitignore
@@ -0,0 +1,40 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/examples/with-next-intl/README.md b/examples/with-next-intl/README.md
new file mode 100644
index 00000000..e215bc4c
--- /dev/null
+++ b/examples/with-next-intl/README.md
@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
diff --git a/examples/with-next-intl/app/[locale]/about/page.tsx b/examples/with-next-intl/app/[locale]/about/page.tsx
new file mode 100644
index 00000000..94e78005
--- /dev/null
+++ b/examples/with-next-intl/app/[locale]/about/page.tsx
@@ -0,0 +1,13 @@
+import { Link } from "@/src/i18n/routing"
+import { useTranslations } from "next-intl"
+
+export default function AboutPage() {
+ const t = useTranslations("AboutPage")
+
+ return (
+
+
{t("title")}
+
+ {children}
+
+ )
+}
diff --git a/examples/with-next-intl/app/[locale]/page.tsx b/examples/with-next-intl/app/[locale]/page.tsx
new file mode 100644
index 00000000..b89d2dd3
--- /dev/null
+++ b/examples/with-next-intl/app/[locale]/page.tsx
@@ -0,0 +1,13 @@
+import { Link } from "@/src/i18n/routing"
+import { useTranslations } from "next-intl"
+
+export default function HomePage() {
+ const t = useTranslations("HomePage")
+
+ return (
+
+
{t("title")}
+
+
+
+
+ Get started by editing{" "}
+
+ app/page.tsx
+
+ .
+
+ Save and see your changes instantly.
+
+
+
+
+
+