Landing (Astro)
apps/landing é um site estático Astro que reutiliza @workspace/ui (shadcn / Tailwind v4) para manter a identidade visual, com ~zero JS do lado do cliente.
Quando usar
- Qualquer alteração em
apps/landing: seções, componentes, estilos ou adição de dados dinâmicos.
Quando NÃO usar
- Os aplicativos Next.js ou mobile — runtimes diferentes.
Modelo zero-JS
- O Astro renderiza componentes React como HTML estático em tempo de build por padrão. Usar um componente shadcn (
<Button>,<Card>,<Badge>) de forma apresentacional não envia JS ao cliente. - JS só é enviado se você adicionar uma diretiva
client:*(client:load,client:visible). Use-a apenas para peças genuinamente interativas e mantenha esse grupo interativo em uma única ilha.tsx— o contexto React não é compartilhado entre ilhas Astro separadas. - Para links estilizados como botões, prefira
<a class={buttonVariants(...)}>em vez de um botão hidratado.
Tailwind v4 + tokens compartilhados (a correção essencial)
- O Tailwind v4 é integrado via
@tailwindcss/viteemastro.config.mjs(a integração antiga@astrojs/tailwindestá obsoleta). src/styles/global.cssimporta o tema compartilhado e adiciona uma fonte de conteúdo Astro:O@import "@workspace/ui/globals.css"; @source "./**/*.{astro,ts,tsx}";globals.csscompartilhado escaneia apenas.ts/.tsx, então sem o@sourceadicionado, classes utilitárias escritas em markup.astronunca são geradas (silenciosamente não se aplicam).- Armadilha de comentário CSS: um comentário CSS que contenha um glob
**/(ex.: descrevendoapps/**/*) fecha o comentário prematuramente (*/), corrompendo a regra seguinte. Mantenha globs fora de comentários.
Dados dinâmicos (quando necessário)
- A landing não tem provider React nem autenticação WorkOS. Para um formulário/chamada dinâmica, use um endpoint de servidor Astro com
ConvexHttpClientdeconvex/browserpara uma mutação/consulta única — nãoConvexReactClient/ConvexProviderWithAuth.
Pegadinhas
- Importar o
@workspace/ui/globals.csscompleto puxa variáveis/animações extras do tema — ok (Tailwind elimina utilitários não usados). - Não há
next-themesaqui, então a landing é apenas modo claro, a menos que você adicione um pequeno script inline de alternância.dark. next/fontnão está disponível — use@fontsource/*ou um<link>para paridade exata de fontes.
Verificar
pnpm --filter landing build→dist/estático;index.htmlnão tem tags<script>para páginas semclient:*.- Uma classe usada apenas em
.astro(ex.:bg-primary) aparece no CSS compilado (a correção@sourcefunciona). pnpm --filter landing typecheck(astro check) passa.