nuxt-studio

SKILL.md

Nuxt Studio

Self-hosted, open-source CMS module for editing Nuxt Content websites in production.

When to Use

Working with:

Installing and configuring nuxt-studio module

Authentication providers (GitHub, GitLab, Google OAuth, SSO, custom)

Git provider setup (GitHub, GitLab, branch config)

Visual content editing (MDC components, YAML/JSON forms, frontmatter)

Media management (public dir, NuxtHub blob, S3, R2)

Publishing flow (draft layer, conflict detection, CI/CD rebuild)

AI-powered content assistance (Vercel AI Gateway)

For content collections/queries: use nuxt-content skill
For NuxtHub storage/database: use nuxthub skill
For Nuxt basics: use nuxt skill
Available Guidance

Read specific files based on current work:

references/configuration.md - Module setup, auth providers, Git providers, environment variables

references/live-editing.md - Visual editor, media management, MDC components, AI features

references/deployment.md - SSR requirements, Git publishing, branch strategies, CI/CD

Loading Files

Consider loading these reference files based on your task:

 references/configuration.md - if installing, configuring auth/git providers, or setting env vars

 references/live-editing.md - if working with content editor, media, components, or AI features

 references/deployment.md - if deploying, configuring branches, or troubleshooting publish flow

DO NOT load all files at once. Load only what's relevant to your current task.

Key Concepts

Concept
Purpose

Auth providers
Control who can access Studio (GitHub, GitLab, Google, SSO)

Git providers
Handle publishing commits to your repository

Draft layer
IndexedDB-backed local storage for unpublished changes

Media manager
Upload/browse files in /public or external blob storage

Visual editor
TipTap-based WYSIWYG with MDC component support

Publishing
Commits drafts to Git, triggers CI/CD rebuild

Quick Start

npx nuxt module add nuxt-studio

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxt/content', 'nuxt-studio'],
  studio: {
    repository: {
      provider: 'github',
      owner: 'your-username',
      repo: 'your-repo',
      branch: 'main',
    },
  },
})

# .env
STUDIO_GITHUB_CLIENT_ID=<client_id>
STUDIO_GITHUB_CLIENT_SECRET=<client_secret>

Access Studio at https://your-site.com/_studio (default route).

Official Documentation

Nuxt Studio: https://nuxt.studio

Setup: https://nuxt.studio/setup

GitHub: https://github.com/nuxt-content/nuxt-studio

Token Efficiency

Main skill: ~300 tokens. Each sub-file: ~800-1200 tokens. Only load files relevant to current task.