Page d'accueil (Astro)
apps/landing est un site statique Astro qui réutilise @workspace/ui (shadcn / Tailwind v4) pour rester cohérent avec la charte graphique, avec ~zéro JavaScript client.
Quand l'utiliser
- Pour toute modification dans
apps/landing: sections, composants, style, ou ajout de données dynamiques.
Quand NE PAS l'utiliser
- Les applications Next.js ou mobile — environnements d'exécution différents.
Modèle zéro-JS
- Par défaut, Astro rend les composants React en HTML statique à la construction. Utiliser un composant shadcn (
<Button>,<Card>,<Badge>) de façon présentative n'envoie aucun JS client. - Le JS n'est envoyé que si vous ajoutez une directive
client:*(client:load,client:visible). Utilisez-la uniquement pour les éléments véritablement interactifs, et regroupez ces interactions dans une seule île.tsx— le contexte React n'est pas partagé entre des îles Astro distinctes. - Pour les liens stylisés comme des boutons, préférez
<a class={buttonVariants(...)}>à un bouton hydraté.
Tailwind v4 + jetons partagés (le correctif essentiel)
- Tailwind v4 est intégré via
@tailwindcss/vitedansastro.config.mjs(l'ancienne intégration@astrojs/tailwindest dépréciée). src/styles/global.cssimporte le thème partagé et ajoute une source de contenu Astro :Le fichier@import "@workspace/ui/globals.css"; @source "./**/*.{astro,ts,tsx}";globals.csspartagé ne scanne que.ts/.tsx, donc sans le@sourceajouté, les classes utilitaires écrites dans le balisage.astrone sont jamais générées (elles ne s'appliquent pas silencieusement).- Piège des commentaires CSS : un commentaire CSS qui contient un glob
**/(par exemple décrivantapps/**/*) ferme le commentaire prématurément (*/), corrompant la règle suivante. Gardez les globs hors des commentaires.
Données dynamiques (si nécessaire)
- La page d'accueil n'a ni fournisseur React ni authentification WorkOS. Pour un formulaire ou un appel dynamique, utilisez un point de terminaison serveur Astro avec
ConvexHttpClientdepuisconvex/browserpour une mutation/requête ponctuelle — pasConvexReactClient/ConvexProviderWithAuth.
Pièges
- Importer le fichier complet
@workspace/ui/globals.cssajoute des variables de thème et animations supplémentaires — sans problème (Tailwind élimine les utilitaires inutilisés). - Pas de
next-themesici, donc la page d'accueil est uniquement en mode clair, à moins d'ajouter un petit script de bascule.darken ligne. next/fontn'est pas disponible — utilisez@fontsource/*ou une balise<link>pour une parité de police exacte.
Vérification
pnpm --filter landing build→dist/statique ;index.htmln'a aucune balise<script>pour les pages sansclient:*.- Une classe utilisée uniquement dans
.astro(par exemplebg-primary) apparaît dans le CSS construit (le correctif@sourcefonctionne). pnpm --filter landing typecheck(astro check) réussit.