AnnexCode – Erste Schritte (Tutorial)
Ein praxisnaher Durchgang („erste Stunde mit AnnexCode"). Whitepaper-Format, PDF-fähig. Screenshots werden nach der Shotlist am Ende aufgenommen.
Ziel dieses Tutorials
Am Ende hast du eine kleine Landingpage gebaut: HTML-Datei mit Bootstrap-Navbar und Hero-Bereich, angepasst über den Inspector, in der WYSIWYG-Vorschau für Desktop und Mobile geprüft, mit lokalem Server getestet, als .axcode-Projekt gespeichert und per FTP auf einen (Demo-)Server hochgeladen.
Schritt 1: Neue HTML-Datei anlegen
Starte AnnexCode und lege über Ablage ▸ Neu (⌘N) eine neue leere HTML-Datei an. Sie erscheint als Tab im Editor mit Syntax-Highlighting. Schreibe ein minimales HTML-Grundgerüst (<!DOCTYPE html>, html, head, body).
Schritt 2: Komponenten per Drag & Drop einfügen
Öffne in der Sidebar das Komponenten-Panel. Ziehe eine Navbar und einen Hero-Bereich in die Vorschau – die zehn fertigen Bootstrap-Komponenten lassen sich direkt platzieren. Der Quelltext im Editor wird dabei automatisch ergänzt.
Schritt 3: Eigenschaften im Inspector anpassen
Wähle die Hero-Komponente aus und passe im Inspector Text, Bild und Farbe an. Die Änderungen werden direkt ins HTML geschrieben – du siehst sie sofort in der Vorschau und im Quelltext.
Schritt 4: Vorschau und Viewports prüfen
Wechsle in der WYSIWYG-Vorschau zwischen den Viewports Desktop (1200), Tablet (768) und Mobile (375). Aktiviere den Edit-Mode und ändere eine Überschrift direkt in der Vorschau – der Text wird in den HTML-Quelltext zurückgeschrieben.
Schritt 5: CSS bearbeiten und Suchen & Ersetzen
Öffne die CSS-Datei des Projekts in einem zweiten Tab und passe eine Farbe an. Nutze die Suchleiste im Editor, um einen Farbwert zu suchen und alle Treffer auf einmal zu ersetzen.
Schritt 6: Lokalen Server starten
Starte den passenden lokalen Entwicklungsserver für dein Projekt (z. B. PHP oder Python http.server). Der Port wird automatisch aus dem Bereich 8100–8199 vergeben. Die Vorschau kann jetzt die Server-URL anzeigen – so prüfst du serverseitige Ausgabe statt statischem Rendering.
Schritt 7: FTP-Verbindung anlegen
Öffne den Verbindungs-Manager und lege eine FTP-Verbindung mit Host, Benutzername und Passwort an. Das Passwort wird im macOS-Schlüsselbund abgelegt, nicht im Projekt. In der FTP-Perspektive siehst du danach den Sync-Status jeder Projektdatei gegenüber dem Server.
Schritt 8: Upload und Speichern
Lade die aktive Datei per Toolbar-Button auf den Server – die Fortschrittsanzeige zeigt den Stand. Speichere dein Projekt anschließend über Ablage ▸ Speichern… (⌘S) als .axcode-Container. Beim Speichern wird das Projekt zusätzlich in den geteilten Versions-Index geschrieben und ist damit über die zentrale Suche in AnnexHub auffindbar.
Ergebnis & nächste Schritte
Du hast eine Landingpage aus fertigen Komponenten aufgebaut, lokal getestet und veröffentlicht – ohne die App zu verlassen. Als Nächstes lohnt sich ein Blick auf das KI-Chat-Panel (Code erklären, refactoren, Tests generieren), die Google-Codes für Analytics & Co. und das integrierte Terminal (Darstellung ▸ Terminal ein-/ausblenden, ⌃⌘T).
Alle Details stehen im Handbuch (docs/manuals/de/AnnexCode.md).
Shotlist (für die Screenshot-Aufnahme)
| Datei | Inhalt | Fensterzustand | Beispieldaten |
|---|---|---|---|
| code-01.png | Editor mit neuer, leerer HTML-Datei und Grundgerüst | Hauptfenster, Editor-Tab aktiv | Demo-Projekt „Café Sonne", index.html |
| code-02.png | Sidebar mit Komponenten-Panel, Drag einer Navbar | Sidebar links geöffnet, Vorschau sichtbar | Navbar + Hero aus dem Komponentenkatalog |
| code-03.png | Inspector mit Eigenschaften der Hero-Komponente | Hero in Vorschau ausgewählt | Titel „Willkommen im Café Sonne", Akzentfarbe |
| code-04.png | WYSIWYG-Vorschau im Mobile-Viewport, Edit-Mode an | Viewport-Auswahl „Mobile (375)" | Hero mit geänderter Überschrift |
| code-05.png | CSS-Datei im Editor mit Suchleiste und Treffern | Zweiter Editor-Tab (styles.css) |
Suche nach Hex-Farbwert, „Alle ersetzen" |
| code-06.png | Server-Log mit laufendem Server und Portangabe | Server-Panel/Log sichtbar | Python-http.server auf Port 8100 |
| code-07.png | Verbindungs-Manager mit ausgefüllter FTP-Verbindung | Sheet „Verbindungen" geöffnet | Demo-Host ftp.beispiel.test, ohne echte Zugangsdaten |
| code-08.png | Upload-Dialog mit Fortschrittsbalken | Upload-Sheet geöffnet | Upload von index.html auf Demo-Server |