guibean/site-estatico

Site Estático Next.js

Wann verwenden

Verwende es für Landing Pages, Unternehmenswebsites, Kampagnenseiten, Portfolios oder Blogs. Das Ergebnis ist reines Frontend, exportiert als HTML/CSS/JS und veröffentlicht auf Cloudflare Pages.

Nicht verwenden, wenn es um Login, Registrierung, Datenbank, Admin-Panel, Bezahlung, Upload oder eigene API geht. In diesen Fällen verwende die Skill sistema-fullstack.

Ein Projekt erstellen

1. Name, endgültige Domain, Ziel der Seite und ob ein Kontaktformular vorhanden ist, bestätigen.
2. Das statische Site-Repository verwenden:

git clone https://github.com/guibean/nextjs-template.git <slug>
cd <slug>
git remote remove origin
git remote add origin https://github.com/guibean/<slug>.git

3. .env.local aus .env.example erstellen und NEXT_PUBLIC_SITE_URL, Name, Autor und E-Mail ausfüllen.
4. pnpm install, pnpm lint, pnpm typecheck und pnpm build ausführen.
5. Erst dann den Inhalt ändern.

Regeln

• Keine Backend-Abhängigkeiten hinzufügen.
• Shadcn-Komponenten bei Bedarf installieren:

pnpm exec shadcn add dialog
pnpm exec shadcn add @aceternity/spotlight

• Für Aceternity-Blöcke die Lizenz prüfen und motion nur installieren, wenn die Komponente es erfordert.
• Ein einziges h1 pro Seite und die Überschriftenhierarchie beibehalten.
• Jede neue Seite benötigt createMetadata, einen Eintrag in der Sitemap und einen navigierbaren Link.
• next/image mit sizes und mit pnpm images verarbeiteten Bildern verwenden.
• In diesem Profil kein output: "server", keine Server Actions oder API Routes von Next verwenden.
• Formular: Turnstile + functions/api/contact.ts + Resend beibehalten.

Checkliste vor der Auslieferung

references/seo-checklist.md lesen und Folgendes bestätigen:

• metadata, canonical, Open Graph und robots
• Sitemap enthält alle öffentlichen Seiten
• llms.txt aktualisiert
• Bilder in assets/images/ und public/images/ generiert
• ein h1, Kontrast, sichtbarer Fokus und Tastaturnavigation
• externe Links mit entsprechendem rel-Attribut
• pnpm lint, pnpm typecheck, pnpm build sind erfolgreich
• Lighthouse ≥ 95 in allen vier Kategorien
• Datenschutz aktualisiert, falls Formular/Analytics vorhanden

Deploy auf Cloudflare Pages

• Build-Befehl: pnpm build
• Ausgabeverzeichnis: out
• Node: 24
• Öffentliche Variablen im Build und Secrets in den Functions
• Domain in NEXT_PUBLIC_SITE_URL, TURNSTILE_HOSTNAME und CONTACT_ALLOWED_ORIGIN konfigurieren