secondsky/claude-skills / plugins/nuxt-studio/skills/nuxt-studio
nuxt-studio
VerifiedThis skill should be used when the user asks to "set up Nuxt Studio", "configure Studio OAuth", "deploy Studio to Cloudflare", "add visual editor to Nuxt", "configure studio.domain.com subdomain", "Studio authentication", "Nuxt CMS", or mentions visual content editing, Nuxt Studio module, TipTap editor, Monaco editor, or content management for Nuxt websites.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.1 KB |
| references/cloudflare-deployment.md | markdown | 12.6 KB |
| references/editor-configuration.md | markdown | 15.0 KB |
| references/oauth-providers.md | markdown | 9.5 KB |
| references/subdomain-setup.md | markdown | 11.4 KB |
| references/troubleshooting.md | markdown | 17.7 KB |
| scripts/check-prerequisites.shexecutable | script | 8.0 KB |
| scripts/test-oauth.shexecutable | script | 6.8 KB |
| scripts/validate-config.shexecutable | script | 7.5 KB |
| templates/nuxt.config.ts | script | 4.4 KB |
| templates/studio-auth-github.ts | script | 6.0 KB |
| templates/studio-auth-gitlab.ts | script | 8.3 KB |
| templates/studio-auth-google.ts | script | 9.3 KB |
| templates/wrangler.toml | config | 4.4 KB |
scripts/test-oauth.sh
View on GitHub#!/bin/bash
# Nuxt Studio OAuth Configuration Tester
# Tests OAuth environment variables setup
# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m'
ISSUES_FOUND=false
echo -e "${BLUE}===================================${NC}"
echo -e "${BLUE}Nuxt Studio OAuth Configuration Tester${NC}"
echo -e "${BLUE}===================================${NC}"
echo ""
success() {
echo -e "${GREEN}✓${NC} $1"
}
error() {
echo -e "${RED}✗${NC} $1"
ISSUES_FOUND=true
}
warning() {
echo -e "${YELLOW}⚠${NC} $1"
}
info() {
echo -e "${BLUE}ℹ${NC} $1"
}
# Check for .env file
ENV_FILE=""
if [ -f ".env.local" ]; then
ENV_FILE=".env.local"
elif [ -f ".env" ]; then
ENV_FILE=".env"
fi
if [ -z "$ENV_FILE" ]; then
warning "No .env or .env.local file found"
info "For local testing, create .env.local with OAuth credentials"
echo ""
info "Testing environment variables from shell..."
echo ""
else
success "Found $ENV_FILE"
echo ""
# Source the env file with error handling
if [ -f "$ENV_FILE" ]; then
set -a
source "$ENV_FILE" || {
error "Failed to source $ENV_FILE"
exit 1
}
set +a
fi
fi
# Function to test OAuth provider
test_provider() {
local PROVIDER=$1
local CLIENT_ID_VAR=$2
local CLIENT_SECRET_VAR=$3
local SERVER_URL_VAR=$4
echo "Testing $PROVIDER OAuth..."
# Check CLIENT_ID
if [ ! -z "${!CLIENT_ID_VAR}" ]; then
# Mask the client ID for security (show first/last 4 chars)
MASKED_ID="${!CLIENT_ID_VAR:0:4}...${!CLIENT_ID_VAR: -4}"
success "$CLIENT_ID_VAR is set ($MASKED_ID)"
else
warning "$CLIENT_ID_VAR is not set"
info "Set $CLIENT_ID_VAR in $ENV_FILE or environment"
return
fi
# Check CLIENT_SECRET
if [ ! -z "${!CLIENT_SECRET_VAR}" ]; then
success "$CLIENT_SECRET_VAR is set (masked for security)"
# Basic validation: secret should be reasonably long
SECRET="${!CLIENT_SECRET_VAR}"
SECRET_LENGTH=${#SECRET}
if [ $SECRET_LENGTH -lt 20 ]; then
warning "$CLIENT_SECRET_VAR seems too short ($SECRET_LENGTH chars)"
info "OAuth secrets are typically 40+ characters"
fi
else
error "$CLIENT_SECRET_VAR is not set"
info "Set $CLIENT_SECRET_VAR in $ENV_FILE or environment"
return
fi
# Check server URL (for GitLab)
if [ ! -z "$SERVER_URL_VAR" ]; then
if [ ! -z "${!SERVER_URL_VAR}" ]; then
success "$SERVER_URL_VAR is set (${!SERVER_URL_VAR})"
# Validate URL format
if [[ ${!SERVER_URL_VAR} =~ ^https?:// ]]; then
success "Server URL format is valid"
else
error "Server URL should start with http:// or https://"
fi
fi
fi
echo ""
}
# Test GitHub OAuth
test_provider "GitHub" "NUXT_OAUTH_GITHUB_CLIENT_ID" "NUXT_OAUTH_GITHUB_CLIENT_SECRET"
# Test GitLab OAuth
test_provider "GitLab" "NUXT_OAUTH_GITLAB_CLIENT_ID" "NUXT_OAUTH_GITLAB_CLIENT_SECRET" "NUXT_OAUTH_GITLAB_SERVER_URL"
# Test Google OAuth
test_provider "Google" "NUXT_OAUTH_GOOGLE_CLIENT_ID" "NUXT_OAUTH_GOOGLE_CLIENT_SECRET"
# Check public Studio URL
echo "Checking public Studio URL..."
if [ ! -z "$NUXT_PUBLIC_STUDIO_URL" ]; then
success "NUXT_PUBLIC_STUDIO_URL is set ($NUXT_PUBLIC_STUDIO_URL)"
# Validate URL format
if [[ $NUXT_PUBLIC_STUDIO_URL =~ ^https?:// ]]; then
success "Studio URL format is valid"
# Check protocol
if [[ $NUXT_PUBLIC_STUDIO_URL =~ ^https:// ]]; then
success "Using HTTPS (recommended for production)"
else
warning "Using HTTP (only for local development)"
info "Use HTTPS for production deployments"
fi
else
error "Studio URL should start with http:// or https://"
fi
# Check for localhost
if [[ $NUXT_PUBLIC_STUDIO_URL =~ localhost ]]; then
info "Using localhost (development mode)"
else
info "Using production URL: $NUXT_PUBLIC_STUDIO_URL"
# Suggest subdomain check
if [[ ! $NUXT_PUBLIC_STUDIO_URL =~ studio\. ]] && [[ ! $NUXT_PUBLIC_STUDIO_URL =~ cms\. ]]; then
warning "URL doesn't use common Studio subdomain (studio. or cms.)"
info "Consider using studio.yourdomain.com for clarity"
fi
fi
else
warning "NUXT_PUBLIC_STUDIO_URL is not set"
info "Set to http://localhost:3000 for local development"
info "Set to https://studio.yourdomain.com for production"
fi
echo ""
# Summary and guidance
echo -e "${BLUE}===================================${NC}"
if [ "$ISSUES_FOUND" = true ]; then
echo -e "${RED}✗ Issues found with OAuth configuration${NC}"
echo ""
echo "Please address the issues above."
echo ""
echo "Quick fix:"
echo "1. Create .env.local file in project root"
echo "2. Add your OAuth credentials:"
echo ""
echo " NUXT_OAUTH_GITHUB_CLIENT_ID=your_client_id"
echo " NUXT_OAUTH_GITHUB_CLIENT_SECRET=your_client_secret"
echo " NUXT_PUBLIC_STUDIO_URL=http://localhost:3000"
echo ""
echo "3. Restart your dev server"
echo ""
echo "For detailed setup, see references/oauth-providers.md"
exit 1
else
PROVIDER_COUNT=0
[ ! -z "$NUXT_OAUTH_GITHUB_CLIENT_ID" ] && PROVIDER_COUNT=$((PROVIDER_COUNT + 1))
[ ! -z "$NUXT_OAUTH_GITLAB_CLIENT_ID" ] && PROVIDER_COUNT=$((PROVIDER_COUNT + 1))
[ ! -z "$NUXT_OAUTH_GOOGLE_CLIENT_ID" ] && PROVIDER_COUNT=$((PROVIDER_COUNT + 1))
if [ $PROVIDER_COUNT -eq 0 ]; then
echo -e "${YELLOW}⚠ No OAuth providers configured${NC}"
echo ""
echo "OAuth is required for production Studio deployment."
echo ""
echo "To set up OAuth:"
echo "1. Choose a provider (GitHub, GitLab, or Google)"
echo "2. Create an OAuth application"
echo "3. Set environment variables"
echo "4. Configure callback URLs"
echo ""
echo "See references/oauth-providers.md for detailed setup."
exit 0
else
echo -e "${GREEN}✓ OAuth configuration looks good!${NC}"
echo ""
echo "Configured providers: $PROVIDER_COUNT"
echo ""
echo "Next steps:"
echo "1. Verify OAuth callback URLs match deployment URL"
echo "2. Test authentication:"
echo " - Start dev server: npm run dev"
echo " - Visit: http://localhost:3000/_studio"
echo " - Click 'Sign in with [Provider]'"
echo "3. Check browser console for errors"
echo ""
echo "For production deployment:"
echo "- Set environment variables on deployment platform"
echo "- Update OAuth callback URLs to production URL"
echo "- Test authentication thoroughly"
exit 0
fi
fi
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |