Communitygithub.com

ASoudy/AGS

Integración experta de Supabase Auth con el App Router de Next.js

¿Qué es AGS?

Esta habilidad proporciona pautas y patrones de código expertos para integrar Supabase Auth con el App Router de Next.js, facilitando la implementación de autenticación segura y eficiente. Incluye configuraciones para clientes de navegador y servidor, middleware de autenticación para proteger rutas y refrescar sesiones, manejo de callbacks OAuth, acciones del servidor para inicio de sesión y cierre de sesión, y acceso al usuario autenticado en componentes del servidor. La habilidad es útil para desarrolladores que buscan implementar autenticación robusta en aplicaciones Next.js con Supabase, ofreciendo validaciones para evitar errores comunes como el uso incorrecto de getSession() en lugar de getUser(), o la falta de middleware para protección de rutas. Funciona en plataformas como Cursor y Codex, y se complementa con otras habilidades como nextjs-app-router y supabase-backend.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/nextjs-supabase-auth

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Next.js + Supabase Auth

Integración experta de Supabase Auth con el App Router de Next.js

Capacidades

  • nextjs-auth
  • supabase-auth-nextjs
  • auth-middleware
  • auth-callback

Prerrequisitos

  • Habilidades requeridas: nextjs-app-router, supabase-backend

Patrones

Configuración del Cliente Supabase

Crear clientes Supabase correctamente configurados para diferentes contextos

Cuándo usarlo: Configurando autenticación en un proyecto Next.js

// lib/supabase/client.ts (Cliente de navegador)
'use client'
import { createBrowserClient } from '@supabase/ssr'

export function createClient() {
  return createBrowserClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL!,
    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
  )
}

// lib/supabase/server.ts (Cliente de servidor)
import { createServerClient } from '@supabase/ssr'
import { cookies } from 'next/headers'

export async function createClient() {
  const cookieStore = await cookies()
  return createServerClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL!,
    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
    {
      cookies: {
        getAll() {
          return cookieStore.getAll()
        },
        setAll(cookiesToSet) {
          cookiesToSet.forEach(({ name, value, options }) => {
            cookieStore.set(name, value, options)
          })
        },
      },
    }
  )
}

Middleware de Autenticación

Proteger rutas y renovar sesiones en el middleware

Cuándo usarlo: Necesitas protección de rutas o renovación de sesiones

// middleware.ts
import { createServerClient } from '@supabase/ssr'
import { NextResponse, type NextRequest } from 'next/server'

export async function middleware(request: NextRequest) {
  let response = NextResponse.next({ request })

  const supabase = createServerClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL!,
    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
    {
      cookies: {
        getAll() {
          return request.cookies.getAll()
        },
        setAll(cookiesToSet) {
          cookiesToSet.forEach(({ name, value, options }) => {
            response.cookies.set(name, value, options)
          })
        },
      },
    }
  )

  // Renovar sesión si ha expirado
  const { data: { user } } = await supabase.auth.getUser()

  // Proteger rutas del dashboard
  if (request.nextUrl.pathname.startsWith('/dashboard') && !user) {
    return NextResponse.redirect(new URL('/login', request.url))
  }

  return response
}

export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
}

Ruta de Callback de Autenticación

Manejar el callback OAuth e intercambiar el código por una sesión

Cuándo usarlo: Usando proveedores OAuth (Google, GitHub, etc.)

// app/auth/callback/route.ts
import { createClient } from '@/lib/supabase/server'
import { NextResponse } from 'next/server'

export async function GET(request: Request) {
  const { searchParams, origin } = new URL(request.url)
  const code = searchParams.get('code')
  const next = searchParams.get('next') ?? '/'

  if (code) {
    const supabase = await createClient()
    const { error } = await supabase.auth.exchangeCodeForSession(code)
    if (!error) {
      return NextResponse.redirect(`${origin}${next}`)
    }
  }

  return NextResponse.redirect(`${origin}/auth/error`)
}

Autenticación en Acciones del Servidor

Manejar operaciones de autenticación en Acciones del Servidor

Cuándo usarlo: Inicio de sesión, cierre de sesión o registro desde Componentes del Servidor

// app/actions/auth.ts
'use server'
import { createClient } from '@/lib/supabase/server'
import { redirect } from 'next/navigation'
import { revalidatePath } from 'next/cache'

export async function signIn(formData: FormData) {
  const supabase = await createClient()
  const { error } = await supabase.auth.signInWithPassword({
    email: formData.get('email') as string,
    password: formData.get('password') as string,
  })

  if (error) {
    return { error: error.message }
  }

  revalidatePath('/', 'layout')
  redirect('/dashboard')
}

export async function signOut() {
  const supabase = await createClient()
  await supabase.auth.signOut()
  revalidatePath('/', 'layout')
  redirect('/')
}

Obtener Usuario en Componente del Servidor

Acceder al usuario autenticado en Componentes del Servidor

Cuándo usarlo: Renderizando contenido específico del usuario en el lado del servidor

// app/dashboard/page.tsx
import { createClient } from '@/lib/supabase/server'
import { redirect } from 'next/navigation'

export default async function DashboardPage() {
  const supabase = await createClient()
  const { data: { user } } = await supabase.auth.getUser()

  if (!user) {
    redirect('/login')
  }

  return (
    <div>
      <h1>Bienvenido, {user.email}</h1>
    </div>
  )
}

Validaciones

Usar getSession() para Verificaciones de Autenticación

Severidad: ERROR

Mensaje: getSession() no verifica el JWT. Usa getUser() para verificaciones de autenticación seguras.

Acción de corrección: Reemplazar getSession() por getUser() para verificaciones críticas de seguridad

OAuth Sin Ruta de Callback

Severidad: ERROR

Mensaje: Usando OAuth pero falta la ruta de callback en app/auth/callback/route.ts

Acción de corrección: Crear app/auth/callback/route.ts para manejar redirecciones OAuth

Cliente de Navegador en Contexto del Servidor

Severidad: ERROR

Mensaje: Cliente de navegador usado en contexto de servidor. Usa createServerClient en su lugar.

Acción de corrección: Importar y usar createServerClient desde @supabase/ssr

Rutas Protegidas Sin Middleware

Severidad: ADVERTENCIA

Mensaje: No se encontró middleware.ts. Considera agregar middleware para protección de rutas.

Acción de corrección: Crear middleware.ts para proteger rutas y renovar sesiones

URL de Redirección de Autenticación Hardcodeada

Severidad: ADVERTENCIA

Mensaje: Redirección localhost hardcodeada. Usa origin para flexibilidad de entorno.

Acción de corrección: Usar window.location.origin o process.env.NEXT_PUBLIC_SITE_URL

Llamada de Autenticación Sin Manejo de Errores

Severidad: ADVERTENCIA

Mensaje: Operación de autenticación sin manejo de errores. Siempre verifica los errores.

Acción de corrección: Desestructurar { data, error } y manejar el caso de error

Acción de Autenticación Sin Revalidación

Severidad: ADVERTENCIA

Mensaje: Acción de autenticación sin revalidatePath. El caché puede mostrar estado de autenticación obsoleto.

Acción de corrección: Agregar revalidatePath('/', 'layout') después de operaciones de autenticación

Protección de Rutas Solo del Lado del Cliente

Severidad: ADVERTENCIA

Mensaje: La protección de rutas del lado del cliente muestra un destello de contenido. Usa middleware.

Acción de corrección: Mover la protección a middleware.ts para mejor experiencia de usuario

Colaboración

Disparadores de Delegación

  • database|rls|queries|tables -> supabase-backend (Auth necesita la capa de base de datos)
  • route|page|component|layout -> nextjs-app-router (Auth necesita patrones de Next.js)
  • deploy|production|vercel -> vercel-deployment (Auth necesita configuración de despliegue)
  • ui|form|button|design -> frontend (Auth necesita componentes de UI)

Stack Completo de Autenticación

Habilidades: nextjs-supabase-auth, supabase-backend, nextjs-app-router, vercel-deployment

Flujo de trabajo:

1. Configuración de base de datos (supabase-backend)
2. Implementación de autenticación (nextjs-supabase-auth)
3. Protección de rutas (nextjs-app-router)
4. Configuración de despliegue (vercel-deployment)

SaaS Protegido

Habilidades: nextjs-supabase-auth, stripe-integration, supabase-backend

Flujo de trabajo:

1. Autenticación de usuario (nextjs-supabase-auth)
2. Sincronización de clientes (stripe-integration)
3. Control de suscripciones (supabase-backend)

Habilidades Relacionadas

Funciona bien con: nextjs-app-router, supabase-backend

Cuándo Usar

  • El usuario menciona o implica: supabase auth next
  • El usuario menciona o implica: authentication next.js
  • El usuario menciona o implica: login supabase
  • El usuario menciona o implica: auth middleware
  • El usuario menciona o implica: protected route
  • El usuario menciona o implica: auth callback
  • El usuario menciona o implica: session management

Limitaciones

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación específica del entorno, las pruebas o la revisión de expertos.
  • Detente y pide aclaraciones si faltan las entradas requeridas, los permisos, los límites de seguridad o los criterios de éxito.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados