К основному содержанию
скилл CX Codex

nuxt-users — скилл для Claude Code: аутентификация в Nuxt

Скилл для Claude Code, Cursor и GitHub Copilot: настраивает модуль nuxt-users — полную систему аутентификации для Nuxt с ролями, сбросом пароля и поддержкой SQLite, MySQL или PostgreSQL.

MIT 292 установок ★ 730 обновлён 2026-11-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add onmax/nuxt-skills --skill nuxt-users -a claude-code
Открыть на GitHub

Что делает nuxt-users

Скилл знает конфигурацию nuxtUsers в nuxt.config.ts (подключение базы, права доступа по ролям, whitelist публичных маршрутов, валидация паролей, настройки mailer для сброса), CLI-команды (npx nuxt-users migrate, create-user), автоимпортируемые composables (useAuthentication, useUsers, usePublicPaths, usePasswordValidation, useNuxtUsersLocale) и готовые компоненты (NUsersLoginForm, NUsersLogoutLink, NUsersUserForm, NUsersList).

Нужны peer-зависимости: db0, better-sqlite3 (или mysql2 / pg для MySQL / PostgreSQL), bcrypt, nodemailer. CLI работает из корня проекта, где лежит nuxt.config.ts; в production без dev-зависимостей используются переменные окружения DB_*. Роли задаются в auth.permissions как ключи словаря; чтобы принимать произвольные роли, включите auth.allowCustomRoles: true.

Скилл подсказывает шаги миграции, структуру таблиц, обработку @success события формы логина через login(user), настройку Google OAuth и guard-логику авторизации.

Какие задачи решает

  • настроить аутентификацию с ролями и правами доступа в Nuxt
  • запустить миграции базы и создать первого пользователя
  • добавить форму логина с composable и компонентом NUsersLoginForm
  • настроить сброс пароля через nodemailer и токены
  • разрешить или запретить доступ к маршрутам по роли

Примеры запросов агенту

  • Добавь nuxt-users в проект, настрой SQLite и запусти миграции
  • Создай пользователя admin через npx nuxt-users create-user
  • Настрой auth.permissions так, чтобы роль user видела /profile и /api/nuxt-users/me

Как установить nuxt-users

1Через Skills CLI (Vercel)

npx skills add onmax/nuxt-skills --skill nuxt-users -a claude-code

2Вручную: положить файлы

~/.claude/skills/nuxt-users/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nuxt-users/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о nuxt-users

Как установить nuxt-users в Claude Code?

Выполни npx skills add onmax/nuxt-skills --skill nuxt-users -a claude-code, скилл появится в ~/.claude/skills/nuxt-users/SKILL.md.

Что делает nuxt-users?

Добавляет в Nuxt полную систему аутентификации: логин, роли, сброс пароля, управление пользователями, авторизацию маршрутов и готовые компоненты форм. Поддерживает SQLite, MySQL и PostgreSQL.

Что нужно для работы nuxt-users?

Установи peer-зависимости: db0, драйвер базы (better-sqlite3, mysql2 или pg), bcrypt и nodemailer. Запускай CLI из корня проекта, где лежит nuxt.config.ts.

Исходный текст

SKILL.md · MIT
---
name: nuxt-users
description: Configure and use the nuxt-users module for Nuxt. Use when adding authentication, user management, roles, password reset, database setup (SQLite/MySQL/PostgreSQL), or CLI commands (migrate, create-user). Covers nuxt.config (nuxtUsers), composables (useAuthentication, useUsers, usePublicPaths, usePasswordValidation, useNuxtUsersLocale), components (NUsersLoginForm, NUsersLogoutLink, etc.), and authorization (whitelist, permissions).
license: MIT
metadata:
  author: rrd108
  version: "1.0"
---

# Nuxt Users skill

## Initial setup

1. **Install the module and peer dependencies**
   ```bash
   npm install nuxt-users
   npm install db0 better-sqlite3 bcrypt nodemailer
   ```
   For MySQL or PostgreSQL, install the corresponding driver (`mysql2` or `pg`) instead of or in addition to `better-sqlite3` as required.

2. **Register the module in `nuxt.config.ts`**
   ```ts
   export default defineNuxtConfig({
     modules: ['nuxt-users']
   })
   ```

3. **Run migrations**
   From the project root (where `nuxt.config.ts` lives):
   ```bash
   npx nuxt-users migrate
   ```

4. **Create at least one user**
   ```bash
   npx nuxt-users create-user -e [email protected] -n "Admin User" -p password123 -r admin
   ```
   Flags: `-e` email, `-n` name, `-p` password, `-r` role (optional).

5. **Configure permissions**
   ```ts
   export default defineNuxtConfig({
     modules: ['nuxt-users'],
     nuxtUsers: {
       auth: {
         permissions: {
           admin: ['*'],
           user: ['/profile', '/api/nuxt-users/me']
         }
       }
     }
   })
   ```

6. **Use login in a page**
   - Use the `NUsersLoginForm` component and handle `@success` by calling `login(user)` from `useAuthentication()`.
   - Optionally redirect after login (e.g. `navigateTo('/')`).

## Configuration reference (nuxt.config.ts)

All options live under `nuxtUsers` in `nuxt.config.ts`.

| Area | Key | Notes |
|------|-----|--------|
| Database | `connector.name` | `'sqlite' \| 'mysql' \| 'postgresql'` |
| Database | `connector.options` | `path` (SQLite), or `host`, `port`, `user`, `password`, `database` (MySQL/PostgreSQL) |
| API | `apiBasePath` | Default `'/api/nuxt-users'` |
| Tables | `tables.users`, `tables.personalAccessTokens`, `tables.passwordResetTokens`, `tables.migrations` | Custom table names |
| Mailer | `mailer` | Nodemailer config for password reset emails |
| URLs | `siteUrl` | Public app URL for links in emails (e.g. `'https://example.com'`). Required in production; the Host header is only trusted in development |
| URLs | `passwordResetUrl`, `emailConfirmationUrl` | Paths for redirects |
| Auth | `auth.whitelist` | Public routes (e.g. `['/register']`); `/login` is always public |
| Auth | `auth.tokenExpiration` | Minutes (default 1440) |
| Auth | `auth.rememberMeExpiration` | Days (default 30) |
| Auth | `auth.permissions` | Role → paths (e.g. `admin: ['*']`, `user: ['/profile']`). Keys are the predefined roles. |
| Auth | `auth.allowCustomRoles` | Default `false`. When `true`, create/update APIs and `NUsersUserForm` accept roles not listed in `permissions`. Empty `permissions` (bootstrap) already accepts any role. |
| Auth | `auth.google` | Google OAuth: `clientId`, `clientSecret`, `callbackUrl`, etc. |
| Password | `passwordValidation` | `minLength`, `requireUppercase`, `requireLowercase`, `requireNumbers`, `requireSpecialChars`, `preventCommonPasswords` |
| Data | `hardDelete` | `true` = hard delete, `false` = soft delete (default) |
| Locale | `locale.default`, `locale.texts`, `locale.fallbackLocale` | Localization |

Runtime config is also supported: use `runtimeConfig.nuxtUsers` for env-based or server-only settings.

## CLI commands

Run from the project root so `nuxt.config.ts` (and optionally `.env`) are found.

- **Migrations**
  ```bash
  npx nuxt-users migrate
  ```

- **Create user**
  ```bash
  npx nuxt-users create-user -e <email> -n "<name>" -p <password> [-r <role>]
  ```
  Role should match a `auth.permissions` key unless `auth.allowCustomRoles` is `true` (or permissions are empty).

- **Legacy/table creation**
  ```bash
  npx nuxt-users create-users-table
  npx nuxt-users create-personal-access-tokens-table
  npx nuxt-users create-password-reset-tokens-table
  npx nuxt-users create-migrations-table
  ```

> **Production:** The CLI requires `nuxt-users` (and peers) installed where Node runs — it is not bundled inside `.output/`. Full config needs the app root with `nuxt.config`; build-only or `--omit=dev` deploys fall back to `DB_*` env vars. See `docs/user-guide/configuration.md`.

## Composables (auto-imported)

- **useAuthentication()** — `user`, `isAuthenticated`, `login(user, rememberMe?)`, `logout()`, `fetchUser(useSSR?)`, `initializeUser()`
- **useUsers()** — Admin: `users`, `pagination`, `loading`, `error`, `fetchUsers(page?, limit?)`, `updateUser`, `addUser`, `removeUser(userId)`
- **usePublicPaths()** — `getPublicPaths()`, `getAccessiblePaths()`, `isPublicPath(path)`, `isAccessiblePath(path, method?)`
- **usePasswordValidation(moduleOptions?, options?)** — `validate(password)`, `isValid`, `errors`, `strength`, `score`, `clearValidation()`
- **useNuxtUsersLocale()** — `t(key, params?)`, `currentLocale`, `fallbackLocale`

## Components

- `NUsersLoginForm` — Login form; use `@success` to call `login(user)` from `useAuthentication()`
- `NUsersLogoutLink` — Logout link/button
- `NUsersProfileInfo` — Display profile
- `NUsersResetPasswordForm` — Password reset form
- `NUsersList` — List users (admin)
- `NUsersUserForm` — Create/edit user form; role select from `auth.permissions` keys; set `auth.allowCustomRoles: true` for a custom free-text role option

## Troubleshooting

| Symptom | Fix |
|---------|-----|
| Redirected to login on protected routes | Set `auth.permissions` so each role has access to needed routes |
| CLI config not found / wrong tables | Run CLI from the directory containing `nuxt.config`; see production note above |
| Migrations table missing | Run `npx nuxt-users migrate` from project root |
| Database driver errors | Install correct peer: SQLite → `better-sqlite3`, MySQL → `mysql2`, PostgreSQL → `pg` |

## File references

- Project LLM context and config types: [llms.txt](https://github.com/rrd108/nuxt-users/blob/ace4a22820a1b1a28951cf1819148c260f841df6/llms.txt) in the repo root
- Full docs: [https://nuxt-users.webmania.cc/](https://nuxt-users.webmania.cc/)
- Getting started and examples: `../../docs/user-guide/getting-started.md`, `../../docs/examples/basic-setup.md`
- Authorization: `../../docs/user-guide/authorization.md`
- Configuration details: `../../docs/user-guide/configuration.md`

Keep `nuxtUsers` config and permissions in sync with the app’s roles and routes; use guard clauses and early returns when implementing custom auth logic.

© rrd108 · MIT · onmax/nuxt-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
clerk-nuxt-patterns clerk Скилл clerk-nuxt-patterns для Claude Code подсказывает проверенные шаблоны авторизации через @clerk/nuxt в приложениях на Nuxt 3. Подключается при настройке маршрутов, серверных обработчиков Nitro и хуков авторизации. CX Codex +1 14 600установок nuxt-server Claude Skills Maintainers Серверная разработка на Nuxt 4 с Nitro — API-роуты, middleware, базы данных и WebSocket. Бэкенд живёт внутри Nuxt-проекта. CX Codex +1 423установок bun-nuxt secondsky Скилл bun-nuxt для запуска Nuxt 3 на Bun runtime в Claude Code, Cursor и других платформах. Помогает настроить dev-сервер, билд и продакшн с использованием Bun вместо Node. CX Codex +1 406установок Supabase Developer daffy0208 Скилл Supabase Developer помогает проектировать базы данных с RLS, настраивать авторизацию, хранилище и Edge Functions на Supabase. CX Codex +1 187установок neon-auth-specialist davila7 Субагент neon-auth-specialist настраивает Stack Auth вместе с базой данных Neon. Он помогает внедрить регистрацию, синхронизацию пользователей и защитные проверки страниц. CX Codex 387установок nuxt Anthony Fu Задаёт правила разработки на Nuxt 5. Помогает писать серверные маршруты на Nitro v3, настраивать гибридный рендеринг и типизировать useFetch. CX Codex +1 24 800установок

Из того же набора13

Весь набор →
nuxthub Скилл nuxthub для Claude Code настраивает базу данных, хранилище KV и работу с blob-файлами в приложениях NuxtHub v0.10.12. Включается при работе со схемами Drizzle ORM, миграциями и деплоем. CX Codex +1 2 300установок nuxt-better-auth Скилл nuxt-better-auth помогает настраивать аутентификацию в Nuxt через @nuxtjs/better-auth, защищать маршруты и работать с сессиями. Пригодится при внедрении Better Auth. CX Codex +1 2 100установок nuxt-studio Настраивает self-hosted Nuxt Studio: авторизацию, медиа, черновики и публикацию через Git на своём домене. CX Codex +1 1 700установок nuxt-i18n Скилл nuxt-i18n для ИИ-агента, который помогает настроить локали, маршруты и SEO в Nuxt-приложении через @nuxtjs/i18n. CX Codex +1 741установок comark Скилл comark парсит markdown с поддержкой Comark-компонентов и рендерит их в Vue, React, Svelte или Angular. Подходит для работы с документацией и контентом, где нужны кастомные блоки. CX Codex +1 306установок arkenv Помогает настроить ArkEnv, описать схему переменных окружения и подключить валидацию в JavaScript-проекте. CX Codex +1 282установок regle Скилл regle для Claude Code помогает добавлять и менять формы с валидацией Regle в Vue 3. Он подсказывает, как связать поля с r$ и показывать ошибки. CX Codex +1 269установок t3-code-continue-thread Скилл t3-code-continue-thread переносит задачу из завершённого треда T3 Code в новую сессию по UUID. Помогает возобновить работу в правильном Git worktree без потери контекста. CX Codex +1 187установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой