Communitygithub.com

deangilmoreremix/videoremix.vip2

Astro-Muster mit Clerk — Middleware, SSR-Seiten, Island-Komponenten, API-Routen, statisches vs. SSR-Rendering. Auslöser: astro clerk, clerk astro middleware, astro geschützte Seite, clerk island Komponente, astro API-Route Auth, clerk astro SSR.

Was ist videoremix.vip2?

Dieses Skill bietet eine umfassende Sammlung von Astro-Entwurfsmustern für die Integration von Clerk als Authentifizierungslösung. Es behandelt die Konfiguration von Middleware zur Routenabsicherung, die Authentifizierung in serverseitig gerenderten (SSR) Seiten mittels `Astro.locals.auth()`, die Verwendung von Clerk in interaktiven Island-Komponenten (React, Vue, Svelte) mit clientseitigen Hooks wie `useAuth()`, sowie die Autorisierung von API-Routen. Ein Schwerpunkt liegt auf dem korrekten Umgang mit den verschiedenen Rendermodi von Astro (SSR vs. statisches Pre-Rendering), da Clerk je nach Modus unterschiedlich funktioniert. Das Skill enthält konkrete Codebeispiele für die Einrichtung (astro.config.mjs, middleware.ts), klärt häufige Fehlerquellen (z. B. fehlende Middleware, falscher output-Modus, nicht reagierende Islands) und liefert eine Import-Übersicht. Es ist für die Verwendung mit dem `@clerk/astro` SDK (v3+) und Astro 4.15+ optimiert.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Astro-Muster

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

Was wird benötigt?

AufgabeReferenz
Middleware konfigurierenreferences/middleware.md
SSR-Seiten schützenreferences/ssr-pages.md
Clerk in Island-Komponenten verwendenreferences/island-components.md
Authentifizierung in API-Routenreferences/api-routes.md
Clerk mit React in Astro verwendenreferences/astro-react.md

Mentales Modell

Astro bietet zwei Rendermodi pro Seite: SSR und statisches Pre-Rendering. Clerk arbeitet in jedem Modus anders:

  • SSR-Seiten – verwenden Astro.locals.auth(), das von der Middleware bereitgestellt wird
  • Statische Seiten (export const prerender = true) – die Clerk-Middleware überspringt sie; verwende clientseitige Hooks in Islands
  • Islands – React/Vue/Svelte-Komponenten; verwende useAuth() und andere Hooks aus @clerk/astro/react
Anfrage → clerkMiddleware() → SSR-Seite → Astro.locals.auth()
                                ↓
                         Island (.client) → useAuth()-Hook

Einrichtung

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

SSR-Seiten-Authentifizierung

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

<h1>Dashboard</h1>

Häufige Fehlerquellen

SymptomUrsacheLösung
Astro.locals.auth ist undefinedFehlende MiddlewareFüge clerkMiddleware in src/middleware.ts hinzu
Authentifizierung funktioniert in der Entwicklung, aber nicht in der Produktionoutput: 'static' global gesetztSetze output: 'server' oder hybrid für geschützte Seiten
Statische Seite hat keine AuthentifizierungVorgerenderte Seiten überspringen die MiddlewareVerwende export const prerender = false oder verlagere in eine Island
Island reagiert nicht auf AnmeldungFehlende client:load-DirektiveFüge client:load zur Island-Komponente hinzu

Import-Übersicht

WasImport von
clerkMiddleware, createRouteMatcher@clerk/astro/server
useAuth, useUser, UserButton@clerk/astro/react
Astro-Komponenten (<SignIn>, usw.)@clerk/astro/components

Umgebungsvariablen

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

Astro verwendet das Präfix PUBLIC_ für clientseitig zugängliche Variablen (nicht NEXT_PUBLIC_).

Siehe auch

  • clerk-setup – Ersteinrichtung von Clerk
  • clerk-custom-ui – Benutzerdefinierte Abläufe und Erscheinungsbild
  • clerk-orgs – B2B-Organisationen

Dokumentation

Astro SDK

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

Verwandte Skills