WorkOS AuthKit Integration Step 1: Fetch AuthKit Documentation (BLOCKING) STOP. Do not proceed until complete. WebFetch: https://workos.com/docs/user-management/authkit This page is the source of truth for AuthKit concepts, supported frameworks, and setup requirements. If this skill conflicts with the docs, follow the docs. Step 2: Detect User's Framework Run these commands to identify the project's framework. Check each in order; use the first match.
Next.js
grep -q '"next"' package.json 2
/dev/null && echo "DETECTED: nextjs"
React Router / Remix
grep -qE '"react-router"|"@remix-run"' package.json 2
/dev/null && echo "DETECTED: react-router"
TanStack Start
grep -q '"@tanstack/start"' package.json 2
/dev/null && echo "DETECTED: tanstack-start"
React (standalone SPA — check AFTER framework-specific entries)
grep -q '"react"' package.json 2
/dev/null && echo "DETECTED: react" If none match, check for a plain HTML/JS project:
Vanilla JS — no package.json or no framework dependency
[ ! -f package.json ] && echo "DETECTED: vanilla-js" ls index.html 2
/dev/null && echo "DETECTED: vanilla-js" Step 3: Route to Framework-Specific Skill Use the detection result from Step 2 to select the correct skill. Do not continue past this step if a framework matched — switch to the matching skill immediately. Detection result --> Skill to invoke ───────────────────────────────────────────── nextjs --> workos-authkit-nextjs react-router --> workos-authkit-react-router tanstack-start --> workos-authkit-tanstack-start react --> workos-authkit-react vanilla-js --> workos-authkit-vanilla-js If a framework is detected: Stop here. The framework-specific skill handles everything from install through verification. If no framework is detected: Ask the user: "Which framework are you using? (Next.js, React, React Router, TanStack Start, or vanilla JS)". If they name something not listed (e.g., Astro, Remix, SvelteKit), use workos-authkit-vanilla-js as the closest starting point and WebFetch https://workos.com/docs/user-management/authkit for framework-specific guidance.