clerk-nuxt-patterns
/clerk-nuxt-patterns
Pokazuje wzorce uwierzytelniania w Nuxt 3 z Clerk: middleware, composable, serwerowe trasy API i SSR.
Ocena i bezpieczeństwo
- Pliki w paczce
- 9
- Skrypty
- 1
- Komentarze HTML
- 1
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
Skrypty: templates/nuxt-basic-auth/nuxt.config.ts
Co robi i kiedy
Pokazuje wzorce uwierzytelniania w Nuxt 3 z Clerk: middleware, composable, serwerowe trasy API i SSR.
Oryginalny opis (EN)
Nuxt 3 auth patterns with @clerk/nuxt - middleware, composables, server API routes, SSR. Triggers on: Nuxt auth, useAuth composable, clerkMiddleware Nuxt, server API Clerk, Nuxt route protection.
Jak działa
- What Do You Need?
- References
- Setup
- Mental Model
- Minimal Pattern
- Common Pitfalls
- Org-Aware Pattern
- See Also
- Docs
Podgląd SKILL.md
---
name: clerk-nuxt-patterns
description: 'Nuxt 3 auth patterns with @clerk/nuxt - middleware, composables, server API routes, SSR. Triggers on: Nuxt auth, useAuth composable, clerkMiddleware Nuxt, server API Clerk, Nuxt route protection.'
license: MIT
allowed-tools: WebFetch
metadata:
author: clerk
version: 1.0.0
---
# Nuxt Patterns
## What Do You Need?
| Task | Reference |
| --------------------------------- | ------------------------------- |
| Protect routes with middleware | references/nuxt-middleware.md |
| Auth in server API routes (Nitro) | references/server-api-routes.md |
| useAuth / useUser in components | references/composables.md |
| SSR-safe auth patterns | references/ssr-auth.md |
## References
| Reference | Description |
| --------------------------------- | ----------------------------------- |
| `references/nuxt-middleware.md` | Route protection, clerkMiddleware() |
| `references/server-api-routes.md` | Nitro server route auth |
| `references/composables.md` | useAuth, useUser, useClerk |
| `references/ssr-auth.md` | SSR hydration, server vs client |
## Setup
```
npm install @clerk/nuxt
```
`.env`:
```
NUXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_...
NUXT_CLERK_SECRET_KEY=sk_...
```
`nuxt.config.ts`:
```typescript
export default defineNuxtConfig({
modules: ['@clerk/nuxt'],
})
```
This single line auto-configures middleware, plugins, and component auto-imports.
## Mental Model
`@clerk/nuxt` auto-imports all Clerk components and composables — no explicit imports needed in `<script setup>`.
- **Composables** (`useAuth`, `useUser`) — client-side reactive, inside `<script setup>`
- **Server routes** (`clerkClient`) — Nitro server routes, `event.context.auth`
- **Middleware** (`clerkMiddleware`) — auto-registered, use `auth().protect()` to lock routes
## Minimal Pattern
```vue
<!-- pages/dashboard.vue -->
<script setup lang="ts">
definePageMeta({ middleware: 'auth' })
const { userId } = useAuth()
</script>
<template>
<Show when="signed-in">
<p>Hello {{ userId }}</p>
</Show>
</template>
```
> `definePageMeta({ middleware: 'auth' })` uses the built-in auth middleware from `@clerk/nuxt`.
## Common Pitfalls
| Symptom | Cause | Fix |
| --- | --- | --- |
| Composables return `undefined` on server | useAuth is client-only | Use `event.context.auth` in server routes |
| Route not protected | Missing `middleware: 'auth'` meta | Add `definePageMeta({ middleware: 'auth' })` |
| `clerkClient` not available | Wrong import path | Import from `@clerk/nuxt/server` |
| Hydration mismatch | Rendering auth state before mounted | Wrap in `<ClientOnly>` or check `isLoaded` |
| Env vars not picked up | Wrong prefix | Nuxt requires `NUXT_PUBLIC_` for public, `NUXT_` for server |
## Org-Aware Pattern
```vue
<script setup lang="ts">
const { orgId, orgRole } = useAuth()
</script>
<template>
<div v-if="orgId">
<p>Org: {{ orgId }}</p>
<p v-if="orgRole === 'org:admin'">Admin panel</p>
</div>
<div v-else>
<OrganizationSwitcher />
</div>
</template>
```
## See Also
- `clerk-setup` - Initial Clerk install
- `clerk-custom-ui` - Custom flows & appearance
- `clerk-orgs` - B2B organizations
## Docs
[Nuxt SDK](https://clerk.com/docs/nuxt/getting-started/quickstart)
Pliki w paczce (9)
- SKILL.md 3 KB
- evals/evals.json 6 KB
- references/composables.md 2 KB
- references/nuxt-middleware.md 1 KB
- references/server-api-routes.md 2 KB
- references/ssr-auth.md 2 KB
- templates/nuxt-basic-auth/app.vue 1 KB
- templates/nuxt-basic-auth/nuxt.config.ts 1 KB
- templates/nuxt-basic-auth/package.json 1 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · clerk/skills | 100 | MIT |
| midudev/autoskills | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 70f18799517a (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100clerk-vue-patterns
Pokazuje wzorce Clerk w Vue 3: composable, guardy Vue Routera i integrację ze sklepem Pinia. - 100clerk-astro-patterns
Podpowiada wzorce uwierzytelniania Clerk w Astro: middleware, strony SSR, komponenty wyspowe, trasy API i ochronę stron. - 100clerk-astro-patterns
Pokazuje wzorce logowania Clerk w Astro: middleware, strony SSR, komponenty wyspowe i chronione trasy API. - 100clerk-vue-patterns
Podpowiada wzorce Clerk w Vue 3: composable useAuth, useUser, useClerk i useOrganization, strażników Vue Router oraz store Pinia. - 95auth0-nuxt
Konfiguruje w Nuxt 3 i 4 uwierzytelnianie Auth0: sesje, ochronę tras middleware, tokeny dostępu i composables przez SDK. - 90clerk-auth
Pokazuje wzorce uwierzytelniania Clerk: middleware, organizacje, webhooki i synchronizację użytkowników.