auth-js

Name: auth-js
Author: jackspace

15stars7forks

How to install auth-js?

jackspace/claudeskillz/auth-js

$npx -y skills add jackspace/ClaudeSkillz --skill auth-js

Installs into the current project.

Summary

Production-ready Auth.js v5 setup for Next.js and Cloudflare Workers. Use when: setting up authentication, implementing OAuth/credentials/magic links, configuring D1 or PostgreSQL adapters, debugging session issues, migrating from v4 to v5, fixing edge compatibility, troubleshoot

Files · 1

View on GitHub

SKILL.md

1	# Auth.js v5 Authentication Stack
2
3	Production-tested: Multiple Next.js and Cloudflare Workers projects
4	Last Updated: 2025-10-26
5	Status: Production Ready ✅
6	Official Docs: https://authjs.dev
7
8	---
9
10	## ⚠️ BEFORE YOU START (READ THIS!)
11
12	CRITICAL FOR AI AGENTS: If you're Claude Code helping a user set up Auth.js:
13
14	1. Explicitly state you're using this skill at the start of the conversation
15	2. Reference patterns from the skill rather than general knowledge
16	3. Prevent known issues listed in `references/common-errors.md`
17	4. Don't guess - if unsure, check the skill documentation
18
19	USER ACTION REQUIRED: Tell Claude to check this skill first!
20
21	Say: "I'm setting up Auth.js - check the auth-js skill first"
22
23	### Why This Matters (Real-World Results)
24
25	Without skill activation:
26	- ❌ Setup time: ~15 minutes
27	- ❌ Errors encountered: 3-5 (AUTH_SECRET, CallbackRouteError, edge issues)
28	- ❌ Manual fixes needed: 3-4 commits
29	- ❌ Token usage: ~15k
30	- ❌ User confidence: Multiple debugging sessions
31
32	With skill activation:
33	- ✅ Setup time: ~3 minutes
34	- ✅ Errors encountered: 0
35	- ✅ Manual fixes needed: 0
36	- ✅ Token usage: ~6k (60% reduction)
37	- ✅ User confidence: Instant success
38
39	### Known Issues This Skill Prevents
40
41	1. Missing AUTH_SECRET → JWEDecryptionFailed error
42	2. CallbackRouteError → Throwing in authorize() instead of returning null
43	3. Route not found → Incorrect file path for [...nextauth].js
44	4. Edge incompatibility → Using database session without edge-compatible adapter
45	5. PKCE errors → OAuth provider misconfiguration
46	6. Session not updating → Missing middleware
47	7. v5 migration issues → Namespace changes, JWT salt changes
48	8. D1 binding errors → Wrangler configuration mismatch
49	9. Credentials with database → Incompatible session strategy
50	10. Production deployment failures → Missing environment variables
51	11. Token refresh errors → Incorrect callback implementation
52	12. JSON expected but HTML received → Rewrites configuration in Next.js 15
53
54	All of these are handled automatically when the skill is active.
55
56	---
57
58	## Table of Contents
59
60	1. [Quick Start - Next.js](#quick-start-nextjs)
61	2. [Quick Start - Cloudflare Workers](#quick-start-cloudflare-workers)
62	3. [Core Concepts](#core-concepts)
63	4. [Session Strategies](#session-strategies)
64	5. [Provider Setup](#provider-setup)
65	6. [Database Adapters](#database-adapters)
66	7. [Middleware Patterns](#middleware-patterns)
67	8. [Advanced Features](#advanced-features)
68	9. [Critical Rules](#critical-rules)
69	10. [Common Errors & Fixes](#common-errors--fixes)
70	11. [Templates Reference](#templates-reference)
71
72	---
73
74	## Quick Start: Next.js
75
76	### Prerequisites
77
78	```bash
79	# Next.js 15+ with App Router
80	npm create next-app@latest my-app
81	cd my-app
82	```
83
84	### Installation
85
86	```bash
87	npm install next-auth@latest
88	npm install @auth/core@latest
89
90	# Choose your database adapter (if using database sessions)
91	npm install @auth/prisma-adapter # For PostgreSQL/MySQL
92	npm install @auth/d1-adapter # For Cloudflare D1
93	```
94
95	### 1. Create Auth Configuration
96
97	Option A: Simple Setup (JWT sessions, no database)
98
99	```typescript
100	// auth.ts
101	import NextAuth from "next-auth"
102	import GitHub from "next-auth/providers/github"
103
104	export const { handlers, auth, signIn, signOut } = NextAuth({
105	providers: [
106	GitHub({
107	clientId: process.env.AUTH_GITHUB_ID,
108	clientSecret: process.env.AUTH_GITHUB_SECRET,
109	}),
110	],
111	})
112	```
113
114	Option B: Edge-Compatible Setup (recommended for middleware)
115
116	```typescript
117	// auth.config.ts (edge-compatible, no database)
118	import type { NextAuthConfig } from "next-auth"
119	import GitHub from "next-auth/providers/github"
120
121	export default {
122	providers: [
123	Gi

People who liked this also viewed

6 picks

Type

auth-js

15stars7forks

View on GitHub

How to install auth-js?

jackspace/claudeskillz/auth-js

$npx -y skills add jackspace/ClaudeSkillz --skill auth-js

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Auth.js v5 Authentication Stack
2
3	Production-tested: Multiple Next.js and Cloudflare Workers projects
4	Last Updated: 2025-10-26
5	Status: Production Ready ✅
6	Official Docs: https://authjs.dev
7
8	---
9
10	## ⚠️ BEFORE YOU START (READ THIS!)
11
12	CRITICAL FOR AI AGENTS: If you're Claude Code helping a user set up Auth.js:
13
14	1. Explicitly state you're using this skill at the start of the conversation
15	2. Reference patterns from the skill rather than general knowledge
16	3. Prevent known issues listed in `references/common-errors.md`
17	4. Don't guess - if unsure, check the skill documentation
18
19	USER ACTION REQUIRED: Tell Claude to check this skill first!
20
21	Say: "I'm setting up Auth.js - check the auth-js skill first"
22
23	### Why This Matters (Real-World Results)
24
25	Without skill activation:
26	- ❌ Setup time: ~15 minutes
27	- ❌ Errors encountered: 3-5 (AUTH_SECRET, CallbackRouteError, edge issues)
28	- ❌ Manual fixes needed: 3-4 commits
29	- ❌ Token usage: ~15k
30	- ❌ User confidence: Multiple debugging sessions
31
32	With skill activation:
33	- ✅ Setup time: ~3 minutes
34	- ✅ Errors encountered: 0
35	- ✅ Manual fixes needed: 0
36	- ✅ Token usage: ~6k (60% reduction)
37	- ✅ User confidence: Instant success
38
39	### Known Issues This Skill Prevents
40
41	1. Missing AUTH_SECRET → JWEDecryptionFailed error
42	2. CallbackRouteError → Throwing in authorize() instead of returning null
43	3. Route not found → Incorrect file path for [...nextauth].js
44	4. Edge incompatibility → Using database session without edge-compatible adapter
45	5. PKCE errors → OAuth provider misconfiguration
46	6. Session not updating → Missing middleware
47	7. v5 migration issues → Namespace changes, JWT salt changes
48	8. D1 binding errors → Wrangler configuration mismatch
49	9. Credentials with database → Incompatible session strategy
50	10. Production deployment failures → Missing environment variables
51	11. Token refresh errors → Incorrect callback implementation
52	12. JSON expected but HTML received → Rewrites configuration in Next.js 15
53
54	All of these are handled automatically when the skill is active.
55
56	---
57
58	## Table of Contents
59
60	1. [Quick Start - Next.js](#quick-start-nextjs)
61	2. [Quick Start - Cloudflare Workers](#quick-start-cloudflare-workers)
62	3. [Core Concepts](#core-concepts)
63	4. [Session Strategies](#session-strategies)
64	5. [Provider Setup](#provider-setup)
65	6. [Database Adapters](#database-adapters)
66	7. [Middleware Patterns](#middleware-patterns)
67	8. [Advanced Features](#advanced-features)
68	9. [Critical Rules](#critical-rules)
69	10. [Common Errors & Fixes](#common-errors--fixes)
70	11. [Templates Reference](#templates-reference)
71
72	---
73
74	## Quick Start: Next.js
75
76	### Prerequisites
77
78	```bash
79	# Next.js 15+ with App Router
80	npm create next-app@latest my-app
81	cd my-app
82	```
83
84	### Installation
85
86	```bash
87	npm install next-auth@latest
88	npm install @auth/core@latest
89
90	# Choose your database adapter (if using database sessions)
91	npm install @auth/prisma-adapter # For PostgreSQL/MySQL
92	npm install @auth/d1-adapter # For Cloudflare D1
93	```
94
95	### 1. Create Auth Configuration
96
97	Option A: Simple Setup (JWT sessions, no database)
98
99	```typescript
100	// auth.ts
101	import NextAuth from "next-auth"
102	import GitHub from "next-auth/providers/github"
103
104	export const { handlers, auth, signIn, signOut } = NextAuth({
105	providers: [
106	GitHub({
107	clientId: process.env.AUTH_GITHUB_ID,
108	clientSecret: process.env.AUTH_GITHUB_SECRET,
109	}),
110	],
111	})
112	```
113
114	Option B: Edge-Compatible Setup (recommended for middleware)
115
116	```typescript
117	// auth.config.ts (edge-compatible, no database)
118	import type { NextAuthConfig } from "next-auth"
119	import GitHub from "next-auth/providers/github"
120
121	export default {
122	providers: [
123	Gi

People who liked this also viewed

6 picks

Type