Communitygithub.com

five-angles-company/convex-starter

Travaillez dans le site marketing Astro situé dans apps/landing. À utiliser pour modifier la page d'accueil, ajouter des sections/composants, utiliser shadcn/@workspace/ui dans Astro, toucher au style de Tailwind v4 ou ajouter des données dynamiques à la page d'accueil. Capture le modèle zéro-JS, le correctif Tailwind @source pour les fichiers .astro et le modèle Convex pour les sites statiques.

Qu'est-ce que convex-starter ?

Ce skill spécialise l'agent AI pour qu'il puisse travailler efficacement sur le site marketing statique Astro situé dans `apps/landing`. Il garantit que toutes les modifications de la page d'accueil, des sections, des composants, du style (Tailwind v4) et de l'ajout de données dynamiques restent cohérentes avec la base de code partagée `@workspace/ui`. Une contribution clé est le correctif `@source` pour Tailwind v4, qui permet de générer des classes utilitaires dans les fichiers `.astro` sans quoi elles seraient silencieusement ignorées, ce qui évite des erreurs de style difficiles à déboguer. Le skill applique également le modèle zéro-JS : les composants React (shadcn) sont rendus en HTML statique par défaut, le JavaScript client n'étant envoyé qu'en cas de nécessité explicite (directive `client:*`). Enfin, il guide l'utilisation de `ConvexHttpClient` pour les requêtes/mutations ponctuelles sur ce site statique sans authentification ni fournisseur React, respectant ainsi une architecture économe en code et en performances.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/five-angles-company/convex-starter/tree/HEAD/.claude/skills/astro-landing

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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/vite dans astro.config.mjs (l'ancienne intégration @astrojs/tailwind est dépréciée).
  • src/styles/global.css importe le thème partagé et ajoute une source de contenu Astro :
    @import "@workspace/ui/globals.css";
    @source "./**/*.{astro,ts,tsx}";
    
    Le fichier globals.css partagé ne scanne que .ts/.tsx, donc sans le @source ajouté, les classes utilitaires écrites dans le balisage .astro ne 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écrivant apps/**/*) 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 ConvexHttpClient depuis convex/browser pour une mutation/requête ponctuelle — pas ConvexReactClient/ConvexProviderWithAuth.

Pièges

  • Importer le fichier complet @workspace/ui/globals.css ajoute des variables de thème et animations supplémentaires — sans problème (Tailwind élimine les utilitaires inutilisés).
  • Pas de next-themes ici, donc la page d'accueil est uniquement en mode clair, à moins d'ajouter un petit script de bascule .dark en ligne.
  • next/font n'est pas disponible — utilisez @fontsource/* ou une balise <link> pour une parité de police exacte.

Vérification

  • pnpm --filter landing build → dist/ statique ; index.html n'a aucune balise <script> pour les pages sans client:*.
  • Une classe utilisée uniquement dans .astro (par exemple bg-primary) apparaît dans le CSS construit (le correctif @source fonctionne).
  • pnpm --filter landing typecheck (astro check) réussit.

Skills associés