FAQ

Antworten kurz und mit Links zu den Folgen und zum Glossar. Alles steht offen auf der Seite, damit du mit der Browsersuche (Strg+F) jede Formulierung findest.

Einstieg

Was ist hautuu überhaupt?

Ein öffentliches Lernprojekt: Astro baut statische Seiten, GitHub speichert den Stand, Cursor hilft beim Bearbeiten, Cloudflare Pages liefert sie aus. Folge 001.

Kann ich das für meine eigene Website nachbauen?

Ja, das ist die Idee. Du brauchst Accounts, etwas Geduld und die Folgen Schritt für Schritt. hautuu zeigt einen Weg, kein fertiger Shop-Baukasten. Folge 001, Über uns.

Brauche ich Programmierkenntnisse?

Nein im klassischen Sinn. Du beschreibst Ziele in normaler Sprache, der Agent ändert Dateien. Terminal-Befehle kannst du oft kopieren. Trotzdem hilft Neugier, wenn etwas hakt. Folge 008, Folge 001.

Was ist der Unterschied zu WordPress?

hautuu ist statisch: keine Datenbank auf dem Server, Inhalte liegen als Dateien in Git. Astro erzeugt HTML beim Build. Folge 002.

Was heißt „statische Website“?

Fertige HTML-Seiten werden ausgeliefert, nicht bei jedem Klick neu aus einer Datenbank zusammengebaut. Das ist dein Frontend. Schnell und schlicht, dafür kein klassisches Plugin-Ökosystem. Glossar Astro, Folge 002.

Was ist der Unterschied zwischen Frontend und Backend?

Frontend sehen Besucher (gebautes HTML/CSS). Das Backend ist bei hautuu vor allem Speicher (GitHub), Redaktion (/admin/) und optional der Worker für OAuth, keine WordPress-Datenbank. Folge 002, Folge 014.

Hat meine Seite überhaupt ein Backend?

Kein klassisches Server-Backend mit Datenbank. Inhalte liegen in Git, die Live-Site ist statisch. Kleine Backend-Bausteine gibt es fürs CMS-Login. Folge 011, Folge 013.

Wo fange ich sinnvoll an?

Repo anlegen, lokal klonen, Cursor öffnen, grobe Richtung verstehen. Danach Issues, Design, Cloudflare, CMS. Folge 001, Folge 002.

Wo liegt die „Wahrheit“, und wo arbeite ich?

Zentral auf GitHub. Lokal ist deine Werkstatt. Nach Push baut Cloudflare die Live-Site. Folge 001, Folge 006.

Muss ich am Anfang alles verstehen?

Nein. Erst ein Bild im Kopf, Details in den Folgen und im Glossar. Folge 001.

Voraussetzungen und Kosten

Was kostet das alles?

Viele Bausteine haben kostenlose Einstiegstarife (öffentliches GitHub-Repo, Cloudflare Pages für statische Sites, Astro als Open Source). Cursor ist kostenpflichtig je nach Plan und Nutzung. Aktuelle Preise immer auf cursor.com, github.com und cloudflare.com prüfen. Folge 009.

Muss ich einen eigenen Server mieten?

Nein. Cloudflare hostet die gebaute Site; du pflegst Code und Inhalte in Git. Folge 011.

Welchen Rechner und welches Betriebssystem brauche ich?

In den Folgen: Linux oder Mac (ähnliche Pfade für Terminal und SSH). Windows geht mit angepassten Tools, im Projekt liegt der Fokus auf Linux/Mac. Folge 017, Folge 018.

Brauche ich eine virtuelle Maschine?

Optional. Manche nutzen eine VM für Experimente oder Cloud Agents; du kannst aber auch direkt auf deinem Rechner starten. Folge 009, Folge 015.

Welche Accounts muss ich anlegen?

Mindestens GitHub und Cursor; für Live-Hosting Cloudflare und Verknüpfung mit dem Repo. Folge 001, Folge 011.

Wie viel Zeit soll ich einplanen?

Das Projekt wächst in vielen Sessions. Plane lieber mehrere Abende ein als „fertig in einer Stunde“. Die Folgen sind der rote Faden.

Reicht mein Internet?

Ja, für Git, Builds in der Cloud und Downloads wie npm install. Große Medien lokal sparen Bandbreite. Folge 018.

Brauche ich Chrome für das CMS?

Für Sveltia online wird Chrome/Chromium empfohlen; Firefox klappt fürs Backend oft nicht. Folge 013.

Ist hautuu nur eine Demo oder „echt“ live?

Echte Site unter der Projekt-Domain, öffentliches Repo, echte Deployments. Du kannst mitlesen und denselben Stack lernen. Über uns.

Muss ich KI extra bezahlen neben Cursor?

Cursor-Abos enthalten Kontingente; stärkere Modelle und Cloud Agents verbrauchen mehr. On-Demand-Nachkauf ist möglich, kann teuer werden. Folge 009.

Terminal und Rechner

Was ist ein Terminal?

Ein Textfenster für Befehle an dein System (Ordner wechseln, Git, npm). In Cursor ist oft ein Terminal eingebaut. Folge 001, Folge 008.

Wie öffne ich ein Terminal?

In Cursor: Terminal-Leiste. Am System: je nach OS ein Programm wie „Terminal“ (Mac/Linux). Folge 001.

Was bedeutet cd?

Change directory: in einen Ordner wechseln. Viele Befehle aus den Folgen setzen voraus, dass du im Projektordner bist. Folge 017.

Warum beendet Strg+C meinen Server?

Im Terminal ist Strg+C Stopp, nicht Kopieren. npm run dev damit beenden. Folge 003.

Was sind versteckte Dateien?

Namen mit Punkt am Anfang (z. B. .git, .env). Im Dateimanager oft per Strg+H sichtbar. Folge 001, Folge 017.

Was ist das Home-Verzeichnis (~)?

Dein persönlicher Ordner unter Linux/Mac. ~/.ssh liegt dort für SSH-Keys. Folge 017.

Der Ordnername auf der Festplatte ist egal?

Ja, für Git zählt der Inhalt mit .git, nicht der Display-Name des Ordners. Folge 006.

Muss mein Rechner laufen, wenn der Cloud Agent arbeitet?

Nein. Der Cloud Agent läuft in der Cloud; du liest das Ergebnis später auf GitHub. Folge 015.

GitHub und Git

Was ist der Unterschied zwischen Git und GitHub?

Git ist die Versionsverwaltung auf deinem Rechner. GitHub ist der Dienst, wo das Repo liegt und Issues/PRs laufen. Folge 001.

Was ist ein Repository?

Der Projektordner unter Versionskontrolle. Glossar Repository, Folge 001.

Was machen Commit, Push und Pull?

Commit speichert lokal, Push schickt zu GitHub, Pull holt Änderungen zu dir. Folge 006.

Warum geht Push manchmal nicht?

GitHub ist oft neuer als dein Ordner. Erst pullen, Konflikte lösen, dann pushen. Folge 006.

Was sind Issues?

Tickets für Bugs, Ideen und Aufgaben. Im Chat: „Bitte Issue #5 umsetzen“. Folge 002.

Was ist ein Pull Request?

Vorschlag, einen Branch in main (oder anders) zu mergen, mit Checks. Glossar Pull Request, Folge 016.

Was ist main?

Der Hauptzweig, den Cloudflare als Production baut. Glossar Main, Folge 012.

Merge oder Rebase?

Merge zeigt die Verzweigung; Rebase linearisiert. Einstieg: Merge reicht. Folge 007.

Wie hole ich das Projekt auf den Rechner?

git clone. Private Repos: SSH-Key. Folge 017.

Ist mein Code öffentlich?

Bei hautuu ja: öffentliches Repo, jeder kann lesen. Schreiben nur mit Berechtigung. Folge 001, Folge 013.

Was ist ein Fork?

Deine Kopie eines fremden Repos unter deinem Account. Glossar Fork, Folge 002.

Was ist origin?

Der Standardname für dein Remote auf GitHub. Glossar Origin, Folge 001.

Cursor und KI

Was ist der Unterschied zwischen Ask, Agent und Plan?

Ask fragt nur, Agent schreibt und nutzt das Terminal, Plan plant erst. Glossar Ask, Agent und Plan, Folge 008.

Warum zwei Chats?

Ein Chat sucht Probleme, einer fixt. Klarere Rollen. Folge 010.

Was sind Cloud Agents?

Agenten in der Cloud, Ergebnis oft ein Pull Request. Glossar Cloud Agent, Folge 015.

Soll der Agent einfach pushen?

Bei hautuu: nur auf dein Wort, sonst ungewolltes Live-Deploy. Folge 003, Folge 002.

Kann die KI Fehler machen?

Ja. PRs, Preview und npm run build prüfen; du liest den Diff. Folge 016, Folge 010.

Wie merke ich, dass die KI Mist gebaut hat?

Rote CI-Checks, Build-Fehler, kaputtes Layout in npm run dev oder Preview. Issue mit konkretem Symptom öffnen. Folge 016.

Was sind Tokens und Kontingente?

Recheneinheiten für Modelle; große Kontexte und Cloud Agents kosten mehr. Folge 009.

Wann Plan-Modus statt direkt Agent?

Bei größeren Features (z. B. Burger-Menü): Plan lesen, korrigieren, dann bauen. Folge 008.

Landen Chats im Repo?

Nur wenn du sie committest. Exporte nach docs/sessions/ und .gitignore nutzen. Folge 008.

Was ist der IDE-Modus?

Dateibaum, Terminal, Agent: so arbeitest du am Projekt, nicht nur im Chat-Fenster. Folge 008.

Issues statt endlos im Chat erklären?

Ja. Issue beschreibt die Aufgabe dauerhaft auf GitHub. Folge 002.

Cloudflare

Was macht Cloudflare Pages hier?

Baut nach Git-Push (npm run build, Output dist) und hostet die Site. Folge 011.

Was ist eine Preview-URL?

Temporäre Adresse für einen Branch, bevor du mergst. Glossar Preview-URL, Folge 012.

Kann ich eine alte Version zurückholen?

Rollback auf ein früheres Deployment. Folge 012.

Was ist der Worker?

Edge-Programm z. B. für CMS-Login, nicht die Website selbst. Folge 014.

Push heißt automatisch neu bauen?

Ja, wenn Pages mit dem Repo verbunden ist. Folge 011.

Wie bekomme ich eine eigene Domain?

Unter Custom domains in Pages, oft CNAME/TLS über Cloudflare. Folge 011.

Was ist die pages.dev-URL?

Die von Cloudflare vergebene Adresse zum Testen, auch für Previews. Folge 011, Folge 012.

Wie lange dauert ein Deploy?

Oft wenige Minuten; manchmal hängt der Hook kurz. Unter Deployments in Cloudflare den Status sehen. Folge 014.

Warum sehe ich meine Änderung nicht online?

Nicht gepusht, falscher Branch, Build noch läuft oder fehlgeschlagen, oder du schaust Preview statt Production. Folge 006, Folge 011.

Woran erkenne ich, welcher Commit live ist?

Kurze Commit-ID in Cloudflare Pages vergleichen mit GitHub. Folge 011.

Sveltia CMS

Was ist Sveltia und wo ist /admin?

Git-basiertes CMS im Browser. Lokal: npm run dev und /admin/. Folge 013.

Wie logge ich mich online ein?

Mit PAT oder später GitHub-Login über Worker. Folge 013, Folge 014.

Was sind Collections?

Inhaltstypen wie pages, articles, menus. Glossar Collection, Folge 004.

Was ist Frontmatter?

Metadaten oben in der Datei; darunter Markdown. Glossar Frontmatter, Folge 004.

Speichern heißt sofort live?

Nur wenn auf main gepusst und Production baut. Sonst Branch/Preview. Folge 012.

Was ist der lokale Modus?

Ordner auf der Platte öffnen, ohne Passwort, weil die Dateien schon da sind. Folge 013.

Was sind Menüs im CMS?

Eigene menus-Collection, nicht nur pro Seite. Folge 014, Folge 004.

Kann ich SEO-Felder pflegen?

Ja, z. B. Tab-Titel und Meta Description im CMS. Folge 013, Folge 004.

Wo landen Bilder?

In der Medienbibliothek unter src/assets oder neben Artikeln, je nach Setup. Folge 013.

Was passiert beim Speichern technisch?

Datei ändert sich, dann Commit zu GitHub, dann Cloudflare-Build. Folge 013.

Node und npm

Brauche ich Node.js?

Ja für npm install, npm run dev und npm run build lokal. Empfohlen: Version 22. Folge 018.

Was macht npm install?

Lädt Abhängigkeiten in node_modules. Glossar npm, Folge 018.

Was ist der Unterschied zwischen npm run dev und npm run build?

dev = Entwicklungsvorschau lokal, build = fertige Site für Production. Folge 005, Folge 018.

Was ist nvm?

Node Version Manager für mehrere Node-Versionen. Folge 018.

Was ist localhost?

Dein Rechner lokal; der Dev-Server zeigt oft Port 4321. Folge 018, Folge 013.

Committe ich node_modules?

Nein. Nur package.json / Lockfile im Repo; installieren kann jeder mit npm install. Folge 018.

Was ist package.json?

Liste der npm-Abhängigkeiten und Skripte wie dev und build. Folge 018.

Baut Cloudflare auch mit npm?

Ja, derselbe Build-Befehl wie lokal. Folge 011, Folge 002.

Inhalte pflegen

Wie schreibe ich einen Artikel ohne Code?

Im CMS unter /admin/ oder Markdown in Cursor. Folge 013.

Wie binde ich ein Video ein?

Artikel-Felder videoProvider (YouTube/Vimeo) und videoId im CMS; in den Folgen oft noch Platzhalter. Folge 001, Folge 016.

Was sind Tags?

Stichworte zu Artikeln, keine tiefe Kategorie-Hierarchie. Folge 004.

Was ist das Artikel-Listing?

Komponente im Seiteninhalt: Anzahl, Sortierung, Grid. Folge 019, Folge 016.

Was ist die Trennlinien-Komponente?

Separator im CMS mit Höhe und Breite. Folge 019.

Wie pflege ich das Glossar?

Eigene Collection glossar, Übersicht unter /glossar/. Glossar, Folge 004.

Kann ich Artikel aus Videos erzeugen lassen?

Transkript + Cloud Agent + Pull Request, dann prüfen. Folge 015.

Wie passe ich Design und Abstände an?

Issues an den Agenten, bestehende CSS-Klassen nutzen. Folge 003, Folge 005.

Was sind Breakpoints?

Layout-Umschaltung z. B. unter 680 px mobil. Glossar Breakpoint, Folge 005.

Seiten-Hintergrundbild?

Optionales Feld in Pages, Lesbarkeit per Overlay. Folge 015, Folge 019.

Rechtliches

Brauche ich Impressum und Datenschutz?

Für einen öffentlichen Auftritt in Deutschland üblicherweise ja. Inhalte prüfen lassen, nicht blind der KI überlassen. Folge 019, Folge 003.

Wo liegen die Texte?

Als normale Pages im Repo, oft im Footer verlinkt. Folge 003.

Sollen Legal-Seiten bei Google indexiert werden?

Oft noindex für Impressum/Datenschutz. Folge 004.

Wie schütze ich die Kontakt-E-Mail?

ENV lokal und Secrets bei Cloudflare, nicht im Repo. Folge 019.

Bildnachweise?

Attribution-Felder; Credits können im Impressum landen. Folge 003, Folge 019.

KI-generierte Rechtstexte ungeprüft übernehmen?

Nein. Unpassende Abschnitte raus, Inhalt an dein Setup anpassen. Folge 019.

Sicherheit

Was darf nie ins Repo?

Passwörter, PATs, API-Keys, private SSH-Keys, echte .env-Werte. Folge 001, Folge 002.

Ist ein PAT wie ein Passwort?

Ja. Einmal kopieren, nicht zeigen, bei Leak widerrufen. Folge 013.

Darf ich meinen privaten SSH-Key teilen?

Nein. Nur die .pub-Datei gehört zu GitHub. Folge 017.

Hilft ein öffentliches Repo Scrapern?

Ja, E-Mail im Klartext wäre sichtbar. Deshalb ENV/Secrets. Folge 019.

Wo liegen OAuth-Secrets?

Als Secrets im Worker, nicht in config.yml im Klartext. Folge 014.

Gelöschte Dateien sind weg?

Aus dem aktuellen Stand ja, in der Historie oft noch lesbar. Folge 006.

Was sind Allowed domains im CMS?

Schutz, welche Domains Sveltia nutzen darf. Folge 014.

Fehler und Problemlösung

Was passiert, wenn ich etwas kaputt mache?

Git behält Historie; Cloudflare Rollback; lokal Änderungen verwerfen. Nicht panisch. Folge 012, Folge 006.

Merge-Konflikt, was tun?

Datei öffnen, Zeilen wählen, committen. Dem Agenten die Situation beschreiben. Folge 006, Folge 014.

PR-Build rot, was jetzt?

Logs lesen, oft npm run build lokal nachstellen, Fix committen. Folge 016.

Permission denied beim Clone?

Meist fehlender SSH-Key oder falscher Key bei GitHub. Folge 017.

npm run dev startet nicht?

Node installiert? Vorher npm install? Folge 018.

/admin geht online nicht?

PAT/OAuth, Chrome, Cloudflare-Build, richtige Domain. Folge 013.

Lokal sieht es anders aus als live?

Push vergessen, anderer Branch, oder Build noch nicht durch. Folge 011.

Preview zeigt es, Production nicht?

Noch nicht auf main gemergt und deployed. Folge 012.

Deployment fehlgeschlagen, Retry?

Retry baut denselben Commit nochmal, ersetzt keinen fehlenden Build. Folge 014.

Der Agent hat 120 Gedankenstriche eingebaut?

Issue: Stil bereinigen, wie nach dem großen Artikel-Import. Folge 016, Folge 019.