Home

The Edge Stack - Wiki

Bienvenido a la documentación completa de The Edge Stack. Esta wiki está diseñada para desarrolladores de todos los niveles, incluyendo aquellos que no tienen experiencia previa con estas tecnologías.

📚 Índice de Documentación

🚀 Primeros Pasos

• Getting Started - Guía paso a paso desde cero hasta el primer endpoint
• Variables de Entorno - Guía completa de configuración de .env
• Variables de Entorno Compartidas - Gestión centralizada en el monorepo
• Turborepo y pnpm - Entendiendo el monorepo
• Flujo de Desarrollo Local - Wrangler, Miniflare, debugging y cloudflared
• Service Bindings y Routing - Gateway, proxy local y evitar CORS
• Gateway - El componente central: enrutamiento, seguridad y observabilidad
• Workers Builds - CI/CD nativo de Cloudflare para Workers
• CI/CD GitHub Actions - Workflows de GitHub Actions para deploy automático
• Despliegue - Lleva tu app a producción

🗄️ Capa de Datos

• Neon PostgreSQL - Base de datos serverless
• Drizzle ORM - ORM type-safe para el edge
• Migraciones y Entornos - Estrategia de migraciones con Neon Branching
• Better Auth y Drizzle - Convivencia de auth y negocio en la misma DB

🔐 Autenticación y API

• Better Auth - Autenticación stateless
• Hono API - Framework ultraligero con RPC

💻 Frontend

• TanStack Start - Dashboard SSR
• Astro - Landing page y blog
• Astro Starlight - Documentación técnica

🎨 Diseño y UI

• Shadcn y Tailwind - Sistema de diseño compartido

☁️ Infraestructura

• Cloudflare Workers - Edge computing
• Local Explorer - Interfaz administrativa local para debugging

💡 Mejores Prácticas

• Consejos y Buenas Prácticas - Tips diarios para desarrollar con este stack

❓ Soporte

• FAQ - Preguntas frecuentes

---

🗺️ Mapa del Stack

Usuario → Cloudflare Gateway → [API | Dashboard | Landing | Blog | Docs]
                                      ↓
                                Neon PostgreSQL

⚡ Stack Tecnológico

Capa	Tecnología	Propósito
Orquestación	Turborepo + pnpm	Monorepo y cacheo
Base de Datos	Neon (Postgres)	Serverless SQL
ORM	Drizzle	Type-safe queries
API	Hono.js	HTTP framework + RPC
Auth	Better Auth	Sesiones stateless
Dashboard	TanStack Start	SSR React
Landing/Blog	Astro	HTML estático
Docs	Starlight	Documentación
UI	Shadcn/ui + Tailwind	Componentes compartidos
Edge	Cloudflare Workers	Runtime edge-first

🆘 ¿Necesitas ayuda?

Si encuentras algo confuso o crees que falta documentación, abre un issue en el repositorio.