Was macht Webseiten-Builder?
Arbeitsablauf
1. Projekt bewerten
Projekttyp bestimmen und Stack auswählen:
| Signal | Stack | Deployment |
|---|---|---|
| Marketingseite, Portfolio, einfache Seiten | Vanilla HTML/CSS/JS oder Astro | Netlify |
| Dynamische App mit Auth, API, Datenbank | Next.js + Tailwind | Vercel |
| Shopify-Store-Seiten (Produkt, Kollektion, Startseite) | Liquid + JSON-Vorlagen | Shopify API |
| Content-lastiger Blog/Doku | Astro + MDX | Netlify |
Detaillierte Kriterien zur Stack-Auswahl findest du in references/stack_guide.md.
2. Designsystem festlegen
Bevor Komponenten geschrieben werden, Design-Tokens definieren:
Farben: primär, sekundär, Akzent, neutral (50-900), Erfolg, Fehler
Typografie: Überschriftenschrift, Textschrift, Skala (xs bis 4xl)
Abstände: 4px Basiseinheit (4, 8, 12, 16, 24, 32, 48, 64)
Radius: sm (4px), md (8px), lg (12px), voll
Schatten: sm, md, lg
Marken-Assets (Logo, Farben, Schriften) konsistent über alle Komponenten anwenden. Muster zur Palettenkonstruktion findest du in references/design_tokens.md. Für Wellness-/E-Commerce-Designinspirationen (Serene Herbs, Magic Mind-Stil) siehe references/design_inspiration.md.
3. Komponenten bauen
Statische Websites: Abschnitt für Abschnitt bauen, Mobile-First. Jeder Abschnitt ist in sich geschlossen mit eigenen Styles.
React/Next.js-Apps: Komponenten-zentrierte Architektur. Baue Atome → Moleküle → Organismen → Seiten.
Shopify-Themes: Als Liquid-Sektionen mit {% schema %}-Blöcken bauen, für Bearbeitbarkeit im Theme-Customizer. Für Shopify-spezifische Muster, Fallstricke und Deployment siehe references/shopify_2_0.md.
4. Deployment
Netlify (statische Websites):
npx netlify-cli deploy --prod --dir=./dist
Shopify (Liquid-Sektionen + JSON-Vorlagen): Verwende gebündelte Skripte, um über die Admin API zu pushen:
scripts/deploy_shopify_section.py—.liquid-Sektionsdateien pushenscripts/deploy_shopify_template.py— JSON-Vorlage pushen und Produkte zuweisen
Vercel (Next.js):
npx vercel --prod
Für Deployment-Details und Sicherheitsmuster siehe references/deployment.md.
Shopify-Kurzreferenz
Shopify ist der fehleranfälligste Stack. Wichtige Fallstricke:
- Blocktypen — Verwende die tatsächlichen Blocktypnamen des Themes (z.B.
titlenicht@app/title) - Richtext-Felder — Keine
style-Attribute auf HTML-Tags; nur semantisches HTML - Farbschemata — Benannt als
scheme-1bisscheme-5(nichtbackground-1) - image-with-text — Inhalt verwendet Blöcke (heading, text, button), NICHT abschnittsbezogene Einstellungen
- template_suffix Sicherheit — Änderung des Suffixes betrifft ALLE Themes; immer zuerst eine Fallback-Vorlage in das Live-Theme pushen
- Ratenbegrenzung —
time.sleep(0.5)zwischen API-Aufrufen einfügen
Vollständige Shopify-Referenz mit Beispielen: references/shopify_2_0.md