Meta-framework con SSR/SSG, enrutado por sistema de archivos y layouts sobre Vite, React y Hono.
En desarrollo activo. Las fases 0-6 están implementadas; las Islas (fase 7) están planificadas.
pnpm dlx @calumet/suamox-create-app my-suamox-app
cd my-suamox-app
pnpm install
pnpm run devConsulta docs/README.md para el índice completo de documentación.
suamox/
packages/
vite-plugin-pages/ # Plugin de rutas por sistema de archivos
ssr-runtime/ # Runtime de SSR/SSG
hono-adapter/ # Adaptador de servidor Hono
head/ # Gestión de head (SSR/SSG/CSR)
router/ # Router del cliente
cli/ # CLI: dev/build/ssg/preview
create-app/ # Scaffold de proyecto
examples/
basic/ # Proyecto de ejemplo
docs/ # Documentación
PLAN.md # Plan de implementación
CONVENTIONS_v1.md # Convenciones del framework (congeladas)- Node.js 18+ o Bun 1.0+
- pnpm 10+
pnpm installpnpm dev
pnpm build
pnpm typecheck
pnpm lint
pnpm format
pnpm testEnrutado por sistema de archivos con rutas estáticas, dinámicas, catch-all y grupos de rutas.
Match de rutas, loaders, renderizado SSR y prerender SSG.
Servidor de desarrollo con Hono + handler SSR para producción.
Gestión de metadatos <head> para SSR/SSG/CSR.
Router del lado cliente para navegación fluida.
Comandos estandarizados dev/build/ssg/preview.
Scaffold de proyecto con plantilla inicial mínima.
- Fase 0: decisiones de diseño y convenciones
- Fase 1: routing y manifest
- Fase 2: runtime SSR
- Fase 3: adaptador Hono (Dev + Prod)
- Fase 4: SSG (prerender)
- Fase 5: layouts
- Fase 6: CLI + Create-app
- Fase 7: Islas (opcional)
Consulta PLAN.md para más detalle.
MIT