Repository
Ein Repository, kurz Repo, ist ein Ordner mit deinem Code samt Änderungsgeschichte. Jeder Baustein deines Projekts hat ein eigenes Repository in GitLab; lokal arbeitest du in einer Kopie.
Git, Commit und Push
Git verwaltet die Änderungsgeschichte; ein Commit ist ein gespeicherter Zwischenstand mit kurzer Nachricht, ein Push lädt Commits nach GitLab hoch. Ein Push auf main startet die Pipeline.
Terminal
Das Terminal ist ein Fenster für Textbefehle; unter Windows heißt es Terminal oder PowerShell, in VS Code oder Cursor öffnest du es über das Menü Terminal. Du brauchst es vor allem für ap run-local und ap login.
Server
Ein Server ist ein Rechner im Internet, der deine Anwendung ausliefert; Backends, Web-Apps und Homepages brauchen einen, reine Mobile-Apps nicht. Unter Server legst du einen eigenen, einen Cloud-Server bei Hetzner oder Hostinger oder einen Managed Server an.
Domain und DNS
Eine Domain ist der lesbare Name deiner Anwendung, etwa example.com; DNS übersetzt ihn über Einträge bei deinem Domain-Anbieter in die Adresse deines Servers. Unter Domains zeigt die Plattform die nötigen Einträge und prüft sie.
Pipeline und Deployment
Eine Pipeline ist eine Kette automatischer Schritte nach jedem Push: testen, Version berechnen, bauen und verteilen. Deployment bringt einen Build auf einen Server, nach jedem Push auf main automatisch auf Dev und per Klick auf Prod.
KI-Agent
Ein KI-Agent wie Claude Code, Cursor oder Codex liest deinen Code, schreibt Änderungen und führt Befehle aus. In jedem Projekt befolgt er die Regeln aus AGENTS.md, und mit dem Agent-Plugin legt er Projekte an, importiert und klont sie.
Docker
Docker verpackt eine Anwendung mit allem, was sie braucht, in einen Container. Die Pipeline baut aus Backend oder Web-App ein Docker-Image für den Server. Lokal braucht ap run-local für die Docker-Dienste eines Backends Docker Desktop.
Umgebungsvariablen
Umgebungsvariablen sind Einstellungen, die eine Anwendung beim Start liest, etwa die Adresse des Backends. Sie liegen im Ordner env/ jedes Repositorys; Dateien mit generated im Namen schreibt die Plattform, eigene Werte gehören in custom-Dateien wie env/local.custom.env.
Workspace
Der lokale Workspace ist der Ordner ~/Documents/application-platform/, in den die Setup-App deine Projekte klont. Ein Remote-Workspace ist ein Entwicklungsrechner in der Cloud, den du unter Workspaces anlegst und per Remote Desktop oder im Browser benutzt.
Organisation und Projekt
Eine Organisation ist der Rahmen für dein Team mit Mitgliedern, Abrechnung, Servern und Anbindungen. Ein Projekt ist ein Produkt darin mit eigener GitLab-Gruppe. Administratoren verwalten Organisation, Projekte und Zugänge; Developer arbeiten an zugewiesenen Projekten.
Damit kannst du dein erstes Projekt anlegen oder ein bestehendes Projekt übernehmen.