Communitygithub.com

deangilmoreremix/videoremix.vip2

Patrons Astro avec Clerk — middleware, pages SSR, composants îlots, routes API, rendu statique vs SSR. Déclenché sur : astro clerk, clerk astro middleware, astro protected page, clerk island component, astro API route auth, clerk astro SSR.

Qu'est-ce que videoremix.vip2 ?

Cette compétence fournit des patrons d'utilisation complets pour intégrer Clerk (solution d'authentification et de gestion d'utilisateurs) dans un projet Astro. Elle couvre la configuration du middleware, la protection des pages en mode SSR, l'utilisation de Clerk dans les composants îlots (islands), l'authentification sur les routes API, ainsi que la différence entre rendu statique et SSR. Elle est conçue pour les développeurs utilisant Astro 4.15+ et le SDK `@clerk/astro` v3+. La compétence explique le modèle mental des deux modes de rendu d'Astro (SSR et prerender statique) et comment Clerk s'y adapte : les pages SSR utilisent `Astro.locals.auth()` via le middleware, tandis que les pages statiques et les îlots s'appuient sur les hooks côté client comme `useAuth()`. Elle inclut des extraits de code pour la configuration (`astro.config.mjs`, `middleware.ts`), l'authentification sur les pages SSR, et une table des pièges courants avec leurs solutions. Enfin, elle fournit une carte d'importation des différents modules Clerk et les variables d'environnement nécessaires.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Patrons Astro

SDK : @clerk/astro v3+. Nécessite Astro 4.15+.

De quoi avez-vous besoin ?

TâcheRéférence
Configurer le middlewarereferences/middleware.md
Protéger les pages SSRreferences/ssr-pages.md
Utiliser Clerk dans les composants îlotsreferences/island-components.md
Authentification dans les routes APIreferences/api-routes.md
Utiliser Clerk avec React dans Astroreferences/astro-react.md

Modèle mental

Astro propose deux modes de rendu par page : SSR et prerender statique. Clerk fonctionne différemment dans chaque mode :

  • Pages SSR — utiliser Astro.locals.auth() qui est alimenté par le middleware
  • Pages statiques (export const prerender = true) — le middleware Clerk les ignore ; utiliser les hooks côté client dans les îlots
  • Îlots — composants React/Vue/Svelte ; utiliser useAuth() et autres hooks de @clerk/astro/react
Requête → clerkMiddleware() → page SSR → Astro.locals.auth()
                                ↓
                         Îlot (.client) → hook useAuth()

Configuration

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

Authentification sur les pages SSR

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

<h1>Tableau de bord</h1>

Pièges courants

SymptômeCauseCorrectif
Astro.locals.auth est indéfiniMiddleware manquantAjouter clerkMiddleware dans src/middleware.ts
L'auth fonctionne en dev mais pas en productionoutput: 'static' globalementDéfinir output: 'server' ou hybrid pour les pages protégées
La page statique n'a pas d'authLes pages pré-rendues ignorent le middlewareUtiliser export const prerender = false ou déplacer dans un îlot
L'îlot ne réagit pas à la connexionDirective client:load manquanteAjouter client:load au composant îlot

Carte d'importation

ÉlémentImporter depuis
clerkMiddleware, createRouteMatcher@clerk/astro/server
useAuth, useUser, UserButton@clerk/astro/react
Composants Astro (<SignIn>, etc.)@clerk/astro/components

Variables d'environnement

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

Astro utilise le préfixe PUBLIC_ pour les variables exposées au client (pas NEXT_PUBLIC_).

Voir aussi

  • clerk-setup - Installation initiale de Clerk
  • clerk-custom-ui - Flux personnalisés et apparence
  • clerk-orgs - Organisations B2B

Documentation

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

Skills associés