AnnexCREATE · Verzeichnis · Tutorials · AnnexCode

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

AnnexCode nach dem Anlegen einer neuen Datei mit leerem Editor

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

Komponenten-Panel in der Sidebar mit Drag & Drop einer Navbar

Ö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

Inspector mit Eigenschaften der Hero-Komponente (Text, Farbe)

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

WYSIWYG-Vorschau im Mobile-Viewport (375)

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

Editor mit CSS-Datei und eingeblendeter Suchleiste

Ö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

Server-Log mit laufendem lokalem Server und Port

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

Verbindungs-Manager mit neuer FTP-Verbindung

Ö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

Upload-Dialog mit Fortschrittsanzeige

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