Communitygithub.com

deangilmoreremix/videoremix.vip2

Padrões Astro com Clerk — middleware, páginas SSR, componentes ilha, rotas de API, renderização estática vs SSR. Acionado por: astro clerk, clerk astro middleware, astro protected page, clerk island component, astro API route auth, clerk astro SSR.

O que é videoremix.vip2?

Esta skill fornece um conjunto de padrões reutilizáveis para integrar o Clerk em projetos Astro, cobrindo cenários comuns como middleware de autenticação, proteção de páginas renderizadas no servidor (SSR), uso de componentes ilha (React/Vue/Svelte) com hooks de autenticação, autenticação em rotas de API e configuração híbrida (SSR + pré-renderização estática). Ela é útil para desenvolvedores que desejam implementar autenticação de forma rápida e consistente em aplicações Astro, evitando armadilhas comuns como esquecer o middleware ou configurar incorretamente o modo de renderização. A skill funciona com `@clerk/astro` v3+ e Astro 4.15+; requer a instalação do Clerk via integração Astro, configuração do middleware em `src/middleware.ts`, e uso de `Astro.locals.auth()` para SSR ou hooks em componentes ilha para client-side. Inclui uma tabela de referência para tarefas comuns, um mapa de importações, variáveis de ambiente e uma seção de soluções para problemas frequentes.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Padrões Astro

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

O Que Você Precisa?

TarefaReferência
Configurar middlewarereferences/middleware.md
Proteger páginas SSRreferences/ssr-pages.md
Usar Clerk em componentes ilhareferences/island-components.md
Autenticação em rotas de APIreferences/api-routes.md
Usar Clerk com React no Astroreferences/astro-react.md

Modelo Mental

Astro tem dois modos de renderização por página: SSR e pré-renderização estática. O Clerk funciona de forma diferente em cada um:

  • Páginas SSR — use Astro.locals.auth(), que é populado pelo middleware
  • Páginas estáticas (export const prerender = true) — o middleware do Clerk as ignora; use hooks client-side em ilhas
  • Ilhas — componentes React/Vue/Svelte; use useAuth() e outros hooks de @clerk/astro/react
Request → clerkMiddleware() → SSR page → Astro.locals.auth()
                                ↓
                         Island (.client) → useAuth() hook

Configuração

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()
})

Autenticação em Página SSR

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

<h1>Dashboard</h1>

Armadilhas Comuns

SintomaCausaCorreção
Astro.locals.auth é undefinedMiddleware ausenteAdicione clerkMiddleware em src/middleware.ts
Autenticação funciona em dev mas não em produçãooutput: 'static' globalmenteDefina output: 'server' ou hybrid para páginas protegidas
Página estática não tem autenticaçãoPáginas pré-renderizadas ignoram middlewareUse export const prerender = false ou mova para uma ilha
Ilha não reage ao loginDiretiva client:load ausenteAdicione client:load ao componente ilha

Mapa de Importação

O QueImportar De
clerkMiddleware, createRouteMatcher@clerk/astro/server
useAuth, useUser, UserButton@clerk/astro/react
Componentes Astro (<SignIn>, etc.)@clerk/astro/components

Variáveis de Ambiente

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

Astro usa o prefixo PUBLIC_ para variáveis expostas ao cliente (não NEXT_PUBLIC_).

Veja Também

  • clerk-setup - Instalação inicial do Clerk
  • clerk-custom-ui - Fluxos personalizados e aparência
  • clerk-orgs - Organizações B2B

Documentação

SDK 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

Habilidades Relacionadas