Communitygithub.com

deangilmoreremix/videoremix.vip2

Clerk を使用した Astro パターン — ミドルウェア、SSR ページ、アイランドコンポーネント、API ルート、静的レンダリングと SSR レンダリング。トリガー: astro clerk、clerk astro middleware、astro protected page、clerk island component、astro API route auth、clerk astro SSR。

videoremix.vip2 とは?

このスキルは、Astro フレームワークで Clerk 認証を統合するためのパターンとベストプラクティスを提供します。SSR ページと静的にプリレンダリングされたページの両方で認証を扱う方法、アイランドコンポーネントでのクライアントサイドフックの使用、API ルートでの認証、ミドルウェアの設定方法を網羅しています。`@clerk/astro` SDK バージョン 3 以降と Astro 4.15 以降が必要です。このスキルは、`Astro.locals.auth()` を使用したサーバーサイド認証と、`useAuth()` などのフックを使用したクライアントサイド認証の違いを明確にし、両方のレンダリングモードをサポートするハイブリッドアプリケーションを構築するのに役立ちます。一般的な落とし穴とその修正方法についてのトラブルシューティング表も含まれています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Astro パターン

SDK: @clerk/astro v3 以降。Astro 4.15 以降が必要です。

必要なもの

タスク参照先
ミドルウェアの設定references/middleware.md
SSR ページの保護references/ssr-pages.md
アイランドコンポーネントでの Clerk の使用references/island-components.md
API ルートでの認証references/api-routes.md
Astro での React との Clerk の使用references/astro-react.md

メンタルモデル

Astro にはページごとに 2 つのレンダリングモードがあります: SSR と 静的プリレンダリング。Clerk はそれぞれで異なる動作をします。

  • SSR ページ — ミドルウェアによって設定される Astro.locals.auth() を使用します。
  • 静的ページ (export const prerender = true) — Clerk ミドルウェアはこれらをスキップします。アイランド内でクライアントサイドフックを使用します。
  • アイランド — React/Vue/Svelte コンポーネント。@clerk/astro/react の useAuth() やその他のフックを使用します。
リクエスト → clerkMiddleware() → SSR ページ → Astro.locals.auth()
                                ↓
                         アイランド (.client) → useAuth() フック

セットアップ

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 ページ認証

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

<h1>ダッシュボード</h1>

よくある落とし穴

症状原因修正
Astro.locals.auth が未定義ミドルウェアがないclerkMiddleware を src/middleware.ts に追加
開発では認証が機能するが本番では機能しないグローバルに output: 'static' が設定されている保護されたページには output: 'server' または hybrid を設定
静的ページに認証がないプリレンダリングされたページはミドルウェアをスキップするexport const prerender = false を使用するか、アイランドに移動
アイランドがサインインに反応しないclient:load ディレクティブがないアイランドコンポーネントに client:load を追加

インポートマップ

何をインポート元
clerkMiddleware, createRouteMatcher@clerk/astro/server
useAuth, useUser, UserButton@clerk/astro/react
Astro コンポーネント (<SignIn> など)@clerk/astro/components

環境変数

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

Astro はクライアント公開変数に PUBLIC_ プレフィックスを使用します (NEXT_PUBLIC_ ではありません)。

関連項目

  • clerk-setup - Clerk の初期インストール
  • clerk-custom-ui - カスタムフローと外観
  • clerk-orgs - B2B 組織

ドキュメント

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

関連スキル