NodeOps Auth Setup

Add NodeOps PKCE OAuth to an existing Next.js (App Router) project.

Prerequisites

Before starting, verify the project is compatible:

• App Router required: Check if app/ directory exists. If only pages/ exists, stop and tell the user: "This skill only supports Next.js App Router. Your project uses Pages Router."
• Next.js required: Check package.json for next in dependencies. If missing, stop and tell the user this is a Next.js-only package.

Idempotency

Before each step, check if the work is already done. Skip steps that are already complete:

• If @nodeops-createos/integration-oauth is already in package.json dependencies, skip install.
• If app/api/auth/me/route.ts and app/api/auth/token/route.ts already exist, skip route creation.
• If AuthProvider from @nodeops-createos/integration-oauth is already imported in the layout, skip wrapping.
• If app/callback/page.tsx (or .jsx) already exists, skip callback page creation.
• If .env.example already exists and contains NODEOPS_, skip env file creation.