Landing (Astro)
apps/landing es un sitio estático de Astro que reutiliza @workspace/ui (shadcn / Tailwind v4) para mantener la coherencia visual, con ~cero JS en el cliente.
Cuándo usarlo
- Cualquier cambio dentro de
apps/landing: secciones, componentes, estilos o la adición de datos dinámicos.
Cuándo NO usarlo
- Las aplicaciones de Next.js o móviles — diferentes entornos de ejecución.
Modelo cero-JS
- Por defecto, Astro renderiza los componentes de React como HTML estático durante el build. Usar un componente shadcn (
<Button>,<Card>,<Badge>) de forma presentacional no envía JS al cliente. - El JS solo se envía si se añade una directiva
client:*(client:load,client:visible). Úsala solo para partes realmente interactivas y mantén ese grupo interactivo en una única isla.tsx— el contexto de React no se comparte entre islas separadas de Astro. - Para enlaces con estilo de botón, prefiere
<a class={buttonVariants(...)}>en lugar de un botón hidratado.
Tailwind v4 + tokens compartidos (la corrección crucial)
- Tailwind v4 se integra mediante
@tailwindcss/viteenastro.config.mjs(la integración antigua@astrojs/tailwindestá obsoleta). src/styles/global.cssimporta el tema compartido y añade una fuente de contenido de Astro:El@import "@workspace/ui/globals.css"; @source "./**/*.{astro,ts,tsx}";globals.csscompartido solo escanea archivos.ts/.tsx, por lo que sin el@sourceadicional, las clases utilitarias escritas en el marcado.astronunca se generan (se aplican en silencio).- Trampa con comentarios CSS: un comentario CSS que contenga un glob
**/(por ejemplo, al describirapps/**/*) cierra el comentario prematuramente (*/), corrompiendo la regla siguiente. Mantén los globs fuera de los comentarios.
Datos dinámicos (cuando sea necesario)
- La página de inicio no tiene proveedor de React ni autenticación de WorkOS. Para un formulario o una llamada dinámica, usa un endpoint de servidor de Astro con
ConvexHttpClientdeconvex/browserpara una mutación/consulta única — no usesConvexReactClient/ConvexProviderWithAuth.
Gotchas
- Importar el
@workspace/ui/globals.csscompleto trae variables de tema y animaciones adicionales — no importa (Tailwind elimina las utilidades no utilizadas). - No hay
next-themesaquí, por lo que la página de inicio es solo modo claro a menos que añadas un pequeño script inline para alternar la clase.dark. next/fontno está disponible — usa@fontsource/*o un<link>para tener la misma fuente exacta.
Verificar
pnpm --filter landing build→dist/estático;index.htmlno tiene etiquetas<script>para páginas sinclient:*.- Una clase usada solo en
.astro(por ejemplo,bg-primary) aparece en el CSS generado (la corrección@sourcefunciona). pnpm --filter landing typecheck(astro check) pasa.