MOTOKO BASEDocumentación
Introducción
Qué es Motoko Base, qué incluye y cómo usar esta documentación.
Motoko Base es un starter SaaS full-stack listo para producción con Next.js. No es un producto final para el usuario — es una base que clonas, configuras y amplías manteniendo los mismos patrones de autenticación, datos, facturación e integraciones.
Usa esta documentación para entender cómo está estructurado el starter, qué incluye de fábrica y cómo personalizarlo para tu propio producto.
¿Qué es Motoko Base?
Motoko Base te entrega un esqueleto de aplicación completo: panel autenticado, rutas protegidas, capa de base de datos, abstracción de facturación, correo transaccional, demos opcionales de almacenamiento e IA, infraestructura de analítica y monitoreo, páginas de marketing y herramientas para desarrolladores.
El objetivo es simple — construye tu SaaS, no su infraestructura. Tú te enfocas en las funcionalidades del producto; el starter se ocupa del cableado repetitivo que todo SaaS necesita.
¿Qué incluye el starter?
Fundación principal
- Autenticación — Better Auth con email/contraseña, verificación, restablecimiento de contraseña y OAuth opcional de Google y GitHub
- Base de datos — PostgreSQL con Drizzle ORM, esquemas tipados y migraciones
- Facturación — Integración con Polar: checkout, suscripciones, webhooks y entitlements (falla de forma suave si no está configurado)
- Email — Resend para correo transaccional (verificación, restablecimiento de contraseña, plantillas)
- Shell del dashboard — Navegación lateral, ajustes, tema y layout protegido
- Sitio de marketing — Landing, sección de precios, docs y changelog
- Analítica y monitoreo — Integraciones con PostHog y Sentry (opcionales, no bloqueantes)
- Infraestructura lista para IA — Vercel AI SDK con un proveedor compatible con OpenAI
Funcionalidades demo
Las demos viven bajo el grupo de navegación Demos. Muestran arquitectura real que puedes copiar a tu producto o eliminar por completo:
- Link Manager — CRUD de enlaces con rutas públicas de redirección (
/r/[slug]) - File Storage — Subidas a Cloudflare R2 con comprobaciones de propiedad
- AI Email — Endpoint de IA en streaming integrado en el dashboard
Las demos están pensadas para poder quitarse. Consulta el README para una checklist segura de eliminación.
¿Para quién es?
Motoko Base está pensado para desarrolladores y equipos pequeños que quieren lanzar un producto SaaS más rápido sin armar el mismo stack desde cero cada vez.
Encaja bien si:
- Quieres una aplicación real y funcional — no una plantilla mínima con rutas de relleno
- Prefieres patrones opinados frente a un lienzo en blanco (server actions, carpetas por feature, validación con Zod)
- Necesitas integraciones de producción cableadas pero que fallen de forma suave cuando faltan variables de entorno
- Planeas poseer y modificar el código — añadir features, quitar demos, cambiar proveedores
No está dirigido a no desarrolladores ni a equipos que buscan un constructor no-code.
Cómo está organizada esta documentación
Los docs son archivos MDX versionados bajo content/docs/, renderizados en /docs con Fumadocs.
- Barra lateral — impulsada por archivos
meta.jsonen cada carpeta; añade páginas creando un MDX y listándolo en elmeta.jsonde la carpeta - Primeros pasos — instalación y configuración inicial (empieza aquí)
- Guías — profundizaciones en features e integraciones (se añaden a medida que crecen los docs)
- Changelog — novedades del producto en
/changelog, también MDX bajocontent/changelog/
Cada página admite frontmatter (title, description) y Markdown estándar. Bloques de código, encabezados y enlaces cruzados funcionan de inmediato.
Para reglas de arquitectura orientadas a agentes, consulta AGENTS.md en la raíz del repositorio.
Prueba la demo en vivo
Antes de instalar en local, explora la aplicación en ejecución:
La demo te permite iniciar sesión, recorrer el dashboard y probar las demos incluidas — autenticación, UI de facturación, ajustes, Link Manager, Storage y AI Email — para ver cómo se comporta el starter en la práctica.
Siguientes pasos
¿Listo para configurar tu propia copia?
Instalación — Clona, configura las variables de entorno, ejecuta migraciones e inicia el servidor de desarrollo.
Estructura del proyecto — Dónde vive el código y cómo están organizadas las carpetas.