Przejdź do treści
Biblioteka skilli
Programowanie · Nauka i wyjaśnianie

clerk-nuxt-patterns

/clerk-nuxt-patterns

Pokazuje wzorce uwierzytelniania w Nuxt 3 z Clerk: middleware, composable, serwerowe trasy API i SSR.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
9
Skrypty
1
Komentarze HTML
1
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. What Do You Need?
  2. References
  3. Setup
  4. Mental Model
  5. Minimal Pattern
  6. Common Pitfalls
  7. Org-Aware Pattern
  8. See Also
  9. Docs
Sekcje z nagłówków SKILL.md, w oryginale · 108 linii, 374 słów
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

RepozytoriumWynikLicencja
Ta strona · clerk/skills100MIT
midudev/autoskills100MIT

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.