From eb0c64e003b2630fa268c087b2dcea55f288efe6 Mon Sep 17 00:00:00 2001
From: Udan Fernando <udanfernando2006@gmail.com>
Date: Wed, 15 Apr 2026 15:07:46 +0530
Subject: [PATCH 1/2] docs(nextjs): fix quickstart middleware pattern to use
 asgardeoMiddleware

---
 packages/nextjs/QUICKSTART.md | 35 +++++++++--------------------------
 1 file changed, 9 insertions(+), 26 deletions(-)

diff --git a/packages/nextjs/QUICKSTART.md b/packages/nextjs/QUICKSTART.md
index 7781965d6..4262de786 100644
--- a/packages/nextjs/QUICKSTART.md
+++ b/packages/nextjs/QUICKSTART.md
@@ -81,21 +81,13 @@ ASGARDEO_CLIENT_SECRET="<your-app-client-secret>"
 
 Create a `middleware.ts` file in your project root to handle authentication:
 
-```bash
-import { AsgardeoNext } from '@asgardeo/nextjs';
-import { NextRequest } from 'next/server';
-
-const asgardeo = new AsgardeoNext();
+> **Note on Next.js 16 compatibility:**
+> Next.js 16 renamed `middleware.ts` to `proxy.ts`. The `@asgardeo/nextjs` SDK currently supports the `middleware.ts` export pattern. Support for Next.js 16's `proxy.ts` may be added in a future SDK release.
 
-asgardeo.initialize({
-  baseUrl: process.env.NEXT_PUBLIC_ASGARDEO_BASE_URL,
-  clientId: process.env.NEXT_PUBLIC_ASGARDEO_CLIENT_ID,
-  clientSecret: process.env.ASGARDEO_CLIENT_SECRET,
-});
+```bash
+import { asgardeoMiddleware } from '@asgardeo/nextjs/server';
 
-export async function middleware(request: NextRequest) {
-  return await asgardeo.middleware(request);
-}
+export default asgardeoMiddleware();
 
 export const config = {
   matcher: [
@@ -219,21 +211,12 @@ If you want to use an embedded login page instead of redirecting to Asgardeo, yo
 Configure the path of the sign-in page in the `middleware.ts` file:
 
 ```diff
-import { AsgardeoNext } from '@asgardeo/nextjs';
-import { NextRequest } from 'next/server';
+import { asgardeoMiddleware } from '@asgardeo/nextjs/server';
 
-const asgardeo = new AsgardeoNext();
-
-asgardeo.initialize({
-  baseUrl: process.env.NEXT_PUBLIC_ASGARDEO_BASE_URL,
-  clientId: process.env.NEXT_PUBLIC_ASGARDEO_CLIENT_ID,
-  clientSecret: process.env.ASGARDEO_CLIENT_SECRET,
+-export default asgardeoMiddleware();
++export default asgardeoMiddleware({
 +  signInUrl: '/signin',
-});
-
-export async function middleware(request: NextRequest) {
-  return await asgardeo.middleware(request);
-}
++});
 
 export const config = {
   matcher: [

From 8f4e7a7a5714383e4c90371be7b7940ba08d3b0f Mon Sep 17 00:00:00 2001
From: Udan Fernando <udanfernando2006@gmail.com>
Date: Sat, 18 Apr 2026 18:21:12 +0530
Subject: [PATCH 2/2] fix(nextjs): correct asgardeoMiddleware parameter order
 in Step 10

---
 packages/nextjs/QUICKSTART.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/nextjs/QUICKSTART.md b/packages/nextjs/QUICKSTART.md
index 4262de786..2491cbe5f 100644
--- a/packages/nextjs/QUICKSTART.md
+++ b/packages/nextjs/QUICKSTART.md
@@ -214,7 +214,7 @@ Configure the path of the sign-in page in the `middleware.ts` file:
 import { asgardeoMiddleware } from '@asgardeo/nextjs/server';
 
 -export default asgardeoMiddleware();
-+export default asgardeoMiddleware({
++export default asgardeoMiddleware(undefined, {
 +  signInUrl: '/signin',
 +});