Communitygithub.com

deangilmoreremix/videoremix.vip2

Patrones de Astro con Clerk: middleware, páginas SSR, componentes isla, rutas API, renderizado estático vs SSR. Se activa con: astro clerk, clerk astro middleware, astro protected page, clerk island component, astro API route auth, clerk astro SSR.

¿Qué es videoremix.vip2?

Este skill proporciona patrones de integración reutilizables entre Astro y Clerk para autenticación. Está diseñado para desarrolladores que usan Astro 4.15+ y `@clerk/astro` v3+. El skill cubre la configuración de middleware con `clerkMiddleware`, la protección de páginas SSR, el uso de Clerk en componentes isla (React, Vue, Svelte) con hooks como `useAuth()`, la autenticación en rutas API y la combinación de Clerk con React dentro de Astro. También aborda los dos modos de renderizado de Astro: SSR y prerenderizado estático, explicando cómo se comporta Clerk en cada uno. Incluye ejemplos de código, una tabla de errores comunes y un mapa de importaciones para saber exactamente qué importar desde `@clerk/astro`. Es compatible con Cursor, Claude Code y otras herramientas de agente de IA que usen skills markdown.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deangilmoreremix/videoremix.vip2/tree/HEAD/.agents/skills/clerk-astro-patterns

Preguntar en tu IA favorita

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

Documentación

Patrones de Astro

SDK: @clerk/astro v3+. Requiere Astro 4.15+.

¿Qué necesitas?

TareaReferencia
Configurar middlewarereferences/middleware.md
Proteger páginas SSRreferences/ssr-pages.md
Usar Clerk en componentes islareferences/island-components.md
Autenticación en rutas APIreferences/api-routes.md
Usar Clerk con React en Astroreferences/astro-react.md

Modelo mental

Astro tiene dos modos de renderizado por página: SSR y prerenderizado estático. Clerk funciona de manera diferente en cada uno:

  • Páginas SSR — usan Astro.locals.auth() que se completa mediante el middleware
  • Páginas estáticas (export const prerender = true) — el middleware de Clerk las omite; usa hooks del lado del cliente en islas
  • Islas — componentes React/Vue/Svelte; usan useAuth() y otros hooks de @clerk/astro/react
Request → clerkMiddleware() → SSR page → Astro.locals.auth()
                                ↓
                         Island (.client) → useAuth() hook

Configuración

astro.config.mjs

import { defineConfig } from 'astro/config'
import clerk from '@clerk/astro'

export default defineConfig({
  integrations: [clerk()],
  output: 'server',
})

src/middleware.ts

import { clerkMiddleware, createRouteMatcher } from '@clerk/astro/server'

const isProtectedRoute = createRouteMatcher(['/dashboard(.*)'])

export const onRequest = clerkMiddleware((auth, context, next) => {
  if (isProtectedRoute(context.request) && !auth().userId) {
    return auth().redirectToSignIn()
  }
  return next()
})

Autenticación en páginas SSR

---
const { userId, orgId } = Astro.locals.auth()
if (!userId) return Astro.redirect('/sign-in')
---

<h1>Dashboard</h1>

Errores comunes

SíntomaCausaSolución
Astro.locals.auth es undefinedFalta middlewareAgrega clerkMiddleware en src/middleware.ts
La autenticación funciona en desarrollo pero no en producciónoutput: 'static' globalEstablece output: 'server' o hybrid para las páginas protegidas
La página estática no tiene autenticaciónLas páginas prerenderizadas omiten el middlewareUsa export const prerender = false o muévelo a una isla
La isla no reacciona al inicio de sesiónFalta la directiva client:loadAgrega client:load al componente isla

Mapa de importaciones

QuéImportar desde
clerkMiddleware, createRouteMatcher@clerk/astro/server
useAuth, useUser, UserButton@clerk/astro/react
Componentes de Astro (<SignIn>, etc.)@clerk/astro/components

Variables de entorno

# .env
PUBLIC_CLERK_PUBLISHABLE_KEY=pk_...
CLERK_SECRET_KEY=sk_...

Astro usa el prefijo PUBLIC_ para las variables expuestas al cliente (no NEXT_PUBLIC_).

Ver también

  • clerk-setup - Instalación inicial de Clerk
  • clerk-custom-ui - Flujos personalizados y apariencia
  • clerk-orgs - Organizaciones B2B

Documentación

SDK de Astro

Individual skills in this repo

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

deangilmoreremix/videoremix.vip2

Implement Clerk authentication for native Android apps using Kotlin and Jetpack Compose with clerk-android source-guided patterns. Use for prebuilt AuthView/UserButton or custom API-driven auth flows. Do not use for Expo or React Native projects.

deangilmoreremix/videoremix.vip2

Clerk Backend REST API explorer and executor. Browse tags, inspect endpoint schemas, and execute authenticated requests. Use when listing users, managing organizations, or calling any Clerk API endpoint.

deangilmoreremix/videoremix.vip2

Clerk Billing for subscription management - render Clerk's PricingTable and in-app checkout drawer, configure subscription plans, seat-limit plans for B2B, feature entitlements with has(), and billing webhooks. Use for SaaS monetization, plan gating, checkout flows, trials, invoicing, and subscription lifecycle management.

deangilmoreremix/videoremix.vip2

Chrome Extension auth with @clerk/chrome-extension -- popup/sidepanel setup, syncHost for OAuth/SAML via web app, createClerkClient for service workers and headless extensions, stable CRX ID. Triggers on: Chrome extension auth, Plasmo clerk, popup sign-in, syncHost, background service worker token, createClerkClient, headless extension.

deangilmoreremix/videoremix.vip2

>- Operate the Clerk CLI (`clerk` binary) for authentication, user/org/session management, deploy verification, instance config, env keys, and any Clerk Backend or Platform API call. Use when the user mentions Clerk management tasks, "list clerk users", "create a clerk user", "update organization", "pull clerk config", "clerk env pull", "clerk doctor", "clerk deploy", "clerk deploy status", "clerk api", or any ad-hoc Clerk API request. Prefer the CLI over raw HTTP: it handles auth, key resolution, app/instance targeting, and formatting automatically.

deangilmoreremix/videoremix.vip2

Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS. Use for custom sign-in/sign-up flows, appearance styling, visual customization, branding.

deangilmoreremix/videoremix.vip2

Agent skill / project related to launch or product demo video: deangilmoreremix/videoremix.vip2

Skills relacionados