🎓 AlexwceDocs — Plataforma de Documentación Premium
Documentación de Nueva Generación con Astro 6, Starlight y Drizzle ORM
AlexwceDocs es una solución de documentación técnica de alto rendimiento creada para alojar manuales, especificaciones de arquitectura y guías de desarrollo de Ryukami Labs. Integra Astro 6, el framework de documentación Starlight, y una capa backend ligera con Drizzle ORM y LibSQL / Turso para analíticas, control de acceso y notas autenticadas.
- 💻 Repositorio GitHub: github.com/Alecwce/AlexwceDocs (Privado)
- ⚡ Stack: Astro 6.0 + Starlight + Drizzle ORM + LibSQL + Vercel SSR
✨ Arquitectura y Capacidades
flowchart TD Dev([👨💻 Desarrollador / Lector]) <--> Portal["🎓 AlexwceDocs\n(Astro 6 + Starlight 0.38)"] Portal --> Search["🔍 Motor de Búsqueda Local\n(Pagefind Offline / Fast Indexing)"] Portal --> Content["📝 Contenido Estructurado MDX\n(Callouts, Tabs, Code Syntax Shiki)"] Portal --> DB["🗄️ Capa de Datos Drizzle ORM\n(LibSQL / Turso SQLite Edge)"] Portal --> Auth["🔐 Seguridad con BcryptJS\n(Protección de guías privadas)"] Portal --> Vercel["☁️ Despliegue Híbrido en Vercel\n(@astrojs/vercel SSR / Edge)"]
- Rendimiento de Próxima Generación:
- Construido sobre Astro 6, garantizando un bundle de JavaScript mínimo y carga instantánea de páginas.
- Búsqueda Instantánea con Pagefind:
- Indexación estática del contenido sin depender de servicios externos de terceros ni cuotas de API.
- Persistencia Ligera con Drizzle & LibSQL:
- Esquemas declarativos en TypeScript con Drizzle ORM sobre base de datos LibSQL (Turso), permitiendo guardar métricas de lectura y roles de acceso.
- Diseño Técnico Pulido:
- Resaltado de sintaxis multi-lenguaje con Shiki, pestañas de código interactivas, bloques de alerta semánticos y soporte completo para modo oscuro.
🛠️ Stack Tecnológico
| Componente | Tecnología | Función |
|---|---|---|
| Framework Base | Astro 6.0.1 | Motor principal SSG/SSR |
| Documentación UI | @astrojs/starlight v0.38.1 | Sistema de navegación, tablas de contenido y búsqueda |
| ORM & Tipado | drizzle-orm v0.45.2 + drizzle.config.ts | Modelado de datos y migraciones tipo-seguras |
| Motor de Base de Datos | @libsql/client (Turso LibSQL) | SQLite distribuido para entornos Edge y serverless |
| Criptografía | bcryptjs | Hasheo de credenciales de acceso para secciones restringidas |
| Despliegue & Hosting | @astrojs/vercel v10.0.4 | Adaptador de servidor para Vercel Functions y Edge |
🚀 Comandos de Trabajo
# Instalación con pnpm
pnpm install
# Servidor de desarrollo local
pnpm dev
# Generar y aplicar migraciones con Drizzle
pnpm drizzle-kit generate
pnpm drizzle-kit push
# Compilación para producción en Vercel
pnpm build🔗 Enlaces y Referencias
- 📖 Ecosistema de Documentación: Complementa a AI Hero Docs y Antigravity CLI Docs.
- 🎯 MOC de Proyectos: Indexado en Proyectos Privados.