MakerKit Documentation Access

Anuncio

"Consultando documentación oficial de MakerKit para [tema]."

Cuándo Usar

Cuando necesites saber "cómo hace MakerKit X"
Cuando encuentres código que no entiendes y el CLAUDE.md local no ayuda
Cuando planifiques una feature y quieras validar el approach oficial
Cuando el MCP no tenga la información (patrones conceptuales vs código)
Cuando configures billing, auth, emails, o features complejas

Cuándo NO Usar

Para introspección de código local (usar MCP)
Para ver qué componentes existen en el proyecto (usar components_search())
Para entender la DB del proyecto (usar get_database_summary())

URL Base

https://makerkit.dev/docs/next-supabase-turbo

Índice Completo

El archivo INDEX.json en este directorio contiene las 150 páginas de documentación organizadas en 21 secciones.

Cómo Usar el Índice

// Leer el índice para encontrar la página correcta
Read(".claude/skills/makerkit-docs/INDEX.json")

// Buscar la sección y página que necesitas
// Construir URL: base_url + path

Resumen de Secciones

| Sección | Slug | Páginas | Temas Clave | |---------|------|---------|-------------| | Installation | installation | 16 | Setup, comandos, migración, MCP | | Configuration | configuration | 7 | Env vars, auth config, feature flags | | Customization | customization | 5 | Tailwind, theme, logo, fonts | | Development | development | 17 | DB architecture, migrations, RBAC, testing | | API | api | 8 | Account, Team, Auth, Workspace APIs | | Data Fetching | data-fetching | 7 | Supabase clients, Server Actions, React Query | | Billing | billing | 12 | Stripe, Lemon Squeezy, Paddle, webhooks | | Content | content | 6 | CMS, Keystatic, Wordpress | | UI Components | components | 14 | Shadcn, forms, tables, marketing | | Notifications | notifications | 2 | Config y envío | | Translations | translations | 3 | i18n, language selector | | Emails | emails | 6 | Config, templates, auth emails | | Monitoring | monitoring | 5 | Sentry, Signoz, PostHog | | Super Admin | admin | 1 | Adding super admin | | Analytics | analytics | 5 | GA, PostHog, Umami, custom | | Security | security | 4 | Next.js practices, RLS, CSP | | Going to Production | going-to-production | 10 | Deploy Vercel, Cloudflare, Docker | | Plugins | plugins | 6 | Waitlist, Roadmap, AI Chatbot | | Recipes | recipes | 7 | Team/Personal accounts, checkout, data model | | Developer Tools | dev-tools | 2 | Env vars, translations editor | | Troubleshooting | troubleshooting | 7 | Install, auth, billing, deploy issues |

Páginas Más Útiles (Acceso Rápido)

Para Desarrollo de Features

| Tema | Path | |------|------| | Database Architecture | /development/database-architecture | | Extending DB Schema | /development/database-schema | | Database Functions | /development/database-functions | | RBAC: Roles & Permissions | /development/permissions-and-roles | | Loading Data | /development/loading-data-from-database | | Writing Data | /development/writing-data-to-database | | Projects Data Model (Recipe) | /recipes/projects-data-model |

Para Data Fetching

| Tema | Path | |------|------| | Supabase Clients | /data-fetching/supabase-clients | | Server Actions | /data-fetching/server-actions | | Server Components | /data-fetching/server-components | | Route Handlers | /data-fetching/route-handlers | | React Query | /data-fetching/react-query |

Para APIs

| Tema | Path | |------|------| | Account API | /api/account-api | | Team Account API | /api/team-account-api | | Authentication API | /api/authentication-api | | Feature Policies API | /api/policies-api |

Para Billing

| Tema | Path | |------|------| | How Billing Works | /billing/overview | | Billing Schema | /billing/billing-schema | | Stripe | /billing/stripe | | Lemon Squeezy | /billing/lemon-squeezy | | Per Seat Billing | /billing/per-seat-billing | | Handling Webhooks | /billing/billing-webhooks |

Para Seguridad

| Tema | Path | |------|------| | Next.js Best Practices | /security/nextjs-best-practices | | Row Level Security | /security/row-level-security | | Data Validation | /security/data-validation |

Para Deploy

| Tema | Path | |------|------| | Production Checklist | /going-to-production/checklist | | Deploy Supabase | /going-to-production/supabase | | Deploy to Vercel | /going-to-production/vercel | | Deploy to Cloudflare | /going-to-production/cloudflare |

Cómo Consultar

Método 1: URL Directa (si conoces el path)

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/development/permissions-and-roles",
  prompt: "Extrae el patrón para implementar RBAC con roles y permisos"
)

Método 2: Buscar en Índice Primero

1. Read(".claude/skills/makerkit-docs/INDEX.json")
2. Buscar la sección relevante
3. WebFetch con el path encontrado

Método 3: Explorar una Sección

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/billing/overview",
  prompt: "Lista todas las subsecciones de billing disponibles en el menú lateral"
)

Ejemplos de Uso

Ejemplo 1: Implementar RBAC

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/development/permissions-and-roles",
  prompt: "Extrae: estructura de tablas para roles/permisos, funciones SQL, y cómo verificar permisos en el código"
)

Ejemplo 2: Configurar Stripe

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/billing/stripe",
  prompt: "Lista: variables de entorno necesarias, configuración de webhooks, y eventos a escuchar"
)

Ejemplo 3: Data Model para Proyectos

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/recipes/projects-data-model",
  prompt: "Extrae: schema SQL completo, políticas RLS, y componentes UI necesarios"
)

Ejemplo 4: Server Actions Pattern

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/data-fetching/server-actions",
  prompt: "Extrae: cómo usar enhanceAction, validación con Zod, y manejo de errores"
)

Ejemplo 5: Troubleshooting Auth

WebFetch(
  url: "https://makerkit.dev/docs/next-supabase-turbo/troubleshooting/troubleshooting-authentication",
  prompt: "Lista problemas comunes de autenticación y sus soluciones"
)

Integración con Otros Tools

Con makerkit-architecture

Cuando diseñes features:

MCP primero: find_complete_features(), analyze_feature_pattern()
Docs para validar: Usa este skill para confirmar patrones oficiales
Combina: Blueprint informado por código real + docs oficiales

Con MCP Database Tools

| Si necesitas... | Usa... | |-----------------|--------| | Ver tablas del proyecto | get_database_summary() | | Entender patrones de tablas | Este skill → /development/database-architecture | | Generar RLS | generate_rls_policy() | | Entender RLS patterns | Este skill → /security/row-level-security |

Notas Importantes

URLs específicas: No existen páginas índice como /billing. Siempre usa paths completos como /billing/overview
Índice local: El archivo INDEX.json tiene las 150 URLs validadas. Consúltalo si no encuentras algo.
Actualización: El índice fue extraído el 2026-01-01. Si MakerKit reorganiza sus docs, puede necesitar actualización.
Contenido dinámico: Algunas páginas cargan contenido con JavaScript. Si WebFetch retorna solo navegación, intenta con un prompt más específico.

Troubleshooting del Skill

| Problema | Solución | |----------|----------| | 404 Not Found | Verificar path en INDEX.json | | Contenido incompleto | Usar prompt más específico | | Solo navegación | La página usa JS; probar otra subsección | | Info desactualizada | WebFetch es en tiempo real, el índice puede estar desactualizado |