Landing (Astro)
apps/landing ist eine statische Astro-Website, die @workspace/ui (shadcn / Tailwind v4) wiederverwendet, um markenkonform zu bleiben – mit nahezu null Client-JavaScript.
Verwendung
- Jede Änderung in
apps/landing: Abschnitte, Komponenten, Styling oder das Hinzufügen dynamischer Daten.
Wann NICHT verwenden
- Die Next.js-Apps oder Mobil – andere Laufzeiten.
Zero-JS-Modell
- Astro rendert React-Komponenten standardmäßig zu statischem HTML zur Build-Zeit. Die Verwendung einer shadcn-Komponente (
<Button>,<Card>,<Badge>) liefert präsentationstechnisch kein Client-JS aus. - JS wird nur ausgeliefert, wenn Sie eine
client:*-Direktive hinzufügen (client:load,client:visible). Verwenden Sie sie nur für wirklich interaktive Teile und behalten Sie diese interaktive Gruppe in einer einzelnen.tsx-Insel – React-Kontext wird nicht über separate Astro-Inseln geteilt. - Für als Buttons gestylte Links bevorzugen Sie
<a class={buttonVariants(...)}>gegenüber einem hydrierten Button.
Tailwind v4 + gemeinsame Tokens (der tragende Fix)
- Tailwind v4 wird über
@tailwindcss/viteinastro.config.mjseingebunden (die alte@astrojs/tailwind-Integration ist veraltet). src/styles/global.cssimportiert das gemeinsame Theme und fügt eine Astro-Inhaltsquelle hinzu:Das gemeinsame@import "@workspace/ui/globals.css"; @source "./**/*.{astro,ts,tsx}";globals.cssscannt standardmäßig nur.ts/.tsx, daher werden ohne die hinzugefügte@sourceUtility-Klassen, die in.astro-Markup geschrieben sind, nie generiert (sie werden stillschweigend nicht angewendet).- CSS-Kommentarfalle: Ein CSS-Kommentar, der einen
**/-Glob enthält (z. B. zur Beschreibung vonapps/**/*), schließt den Kommentar vorzeitig (*/) und beschädigt die nächste Regel. Halten Sie Globs aus Kommentaren heraus.
Dynamische Daten (bei Bedarf)
- Die Landing Page hat keinen React-Provider und keine WorkOS-Authentifizierung. Verwenden Sie für ein Formular/einen dynamischen Aufruf einen Astro Server-Endpunkt mit
ConvexHttpClientausconvex/browserfür eine einmalige Mutation/Query – nichtConvexReactClient/ConvexProviderWithAuth.
Fallstricke
- Das Importieren des vollständigen
@workspace/ui/globals.csszieht zusätzliche Theme-Variablen/Animationen herein – das ist in Ordnung (Tailwind entfernt ungenutzte Utilities). - Es gibt kein
next-themeshier, daher ist die Landing Page nur hell (light-only), es sei denn, Sie fügen ein kleines Inline-.dark-Umschalt-Skript hinzu. next/fontist nicht verfügbar – verwenden Sie@fontsource/*oder einen<link>für exakte Schriftarten-Gleichheit.
Überprüfung
pnpm --filter landing build→ statischesdist/;index.htmlhat keine<script>-Tags für Seiten ohneclient:*.- Eine Klasse, die nur in
.astroverwendet wird (z. B.bg-primary), erscheint im gebauten CSS (der@source-Fix funktioniert). pnpm --filter landing typecheck(astro check) wird bestanden.