Markdown

Dokumentation

Dokumentation

Anleitungen für den Einstieg, die tägliche Arbeit und das Veröffentlichen deiner Projekte auf MainPath, getrennt nach Einsteigern und Entwicklern.

Der Schnellstart bringt dich in vier Schritten auf MainPath: CLI, Agent-Plugin, Projekt, Veröffentlichen. Wer Git, Terminal und Server noch nicht kennt, folgt danach dem Pfad Für Einsteiger; wer täglich entwickelt, nimmt den kürzeren Pfad Für Entwickler. Beide verlinken auf dieselbe Referenz weiter unten, in der jedes Thema einmal beschrieben ist.

So läuft die Arbeit

Du entwickelst auf deinem Rechner oder im Remote-Workspace, gemeinsam mit deinem KI-Agenten. Ein Push auf main startet die Pipeline: Sie prüft, baut und aktualisiert automatisch die Testumgebung. Du probierst deine Änderungen aus und gibst die Version anschließend für Produktion frei.

Vom ersten Prompt bis zur Freigabe
flowchart TB
  accTitle: Vom ersten Prompt bis zur Freigabe
  accDescr: Du arbeitest mit deinem KI-Agenten lokal oder im Workspace. Nach einem Push auf main prüft und baut die GitLab-Pipeline dein Projekt. Die Testumgebung wird automatisch aktualisiert. Produktion gibst du selbst frei.
  code["Du + dein KI-Agent<br/>Lokal oder im Workspace"]
  pipeline["GitLab Pipeline<br/>Prüfen · Bauen · Versionieren"]
  dev["Testumgebung<br/>Deine Änderungen ausprobieren"]
  prod["Produktion<br/>Für deine Nutzer"]
  code -->|Push auf main| pipeline
  pipeline -->|automatisch| dev
  pipeline -->|deine Freigabe| prod
  class pipeline accent
  class prod success

Du behältst die Freigabe in der Hand. Produktion startest du über den manuellen Job in derselben Pipeline. Dev- und Prod-Server sind getrennt, mit Firewall und HTTPS. Für den Betrieb kannst du Backups und Monitoring einrichten; verbindest und aktivierst du Sentry, werden dort Fehler gesammelt. Das technische Zusammenspiel erklärt die Architektur.

Die Suche links oben findet Überschriften und Text aller Seiten.

Schnellstart

Für Einsteiger

Was ist MainPath?

MainPath übernimmt Repositories, Pipelines, Server und Deployments, damit du dich auf deine Anwendung konzentrieren kannst.

Begriffe, die dir begegnen

Repository, Commit, Pipeline, Server, Docker und Workspace sind Begriffe, die dir auf MainPath ständig begegnen, und jeder von ihnen wird kurz und mit Plattform-Bezug erklärt.

Dein erstes Projekt anlegen

Du registrierst dich, legst eine Organisation an und erstellst im Assistenten dein erstes Projekt, das MainPath mit Repositories in GitLab generiert.

Bestehendes Projekt übernehmen

Ein Ordner, den du mit Claude Code, Cursor oder Codex gebaut hast, kommt mit einem Prompt auf MainPath, sofern sein Tech-Stack unterstützt wird.

Rechner einrichten oder im Browser arbeiten

Du arbeitest entweder auf deinem eigenen Rechner, den die MainPath Toolbox einrichtet, oder in einem Remote-Workspace in der Cloud, und beide Wege führen zum gleichen Projektordner.

Projekt öffnen und starten

Du öffnest den Projektordner im Editor, startest ein Terminal, lässt die Anwendung mit mp run-local laufen und siehst sie dir im Browser an.

Mit einem KI-Agenten arbeiten

Claude Code, Cursor und Codex kennen die Regeln von MainPath und sprechen über das Agent-Plugin direkt mit der Plattform.

Änderungen sichern und veröffentlichen

Mit Commit und Push landen deine Änderungen in GitLab, die Pipeline bringt sie auf den Dev-Server, und Produktion gibst du per Klick frei.

Wenn etwas nicht klappt

Die typischen Stolperstellen beim Einstieg lassen sich meist selbst prüfen, und wenn das nicht reicht, hilft der Support.

Was ist GitLab?

GitLab ist der Ort, an dem der Code deiner Projekte liegt und die Pipelines laufen, und im Alltag brauchst du davon nur wenige Funktionen.

Was sind Pipelines?

Eine Pipeline testet, versioniert, baut und verteilt deine Anwendung nach jedem Push auf main, und den letzten Schritt nach Produktion startest du selbst.

Für Entwickler

Entwicklungsumgebung

Editoren und KI-Agenten

Anbindungen und Dienste

Veröffentlichen

Server

Backends, Browser-Apps und Webseiten laufen auf einem Server, den du auf einem von vier Wegen mit MainPath verbindest.

Domain

Damit dein Projekt unter einem eigenen Namen erreichbar ist, trägst du eine Domain ein und setzt beim Domain-Anbieter die DNS-Einträge, die MainPath dir anzeigt.

Apps (iOS und Android)

Die Pipeline baut und signiert deine App, verteilt sie an TestFlight und den Internal Track und wartet dann auf deine Freigabe in den Store.

Desktop-Anwendungen

Die Pipeline baut Installer für macOS, Windows und Linux, signiert sie auf Wunsch und lädt macOS-Apps bei Bedarf in den Mac App Store.

Browser-Apps

Eine Browser-App aus Flutter Web, React Native Web oder Next.js läuft als Docker-Container auf deinem Server, bekommt ihre Dev-Adresse automatisch und für Produktion deine eigene Domain.

Webseiten

Hugo- und Astro-Seiten bestehen aus statischen Dateien, die die Pipeline baut und entweder auf deinen Docker-Server oder auf einen bestehenden Webspace ausliefert.

Backend

Dein Backend aus NestJS, FastAPI oder Laravel läuft als Docker-Container auf deinem Server, zusammen mit der MySQL-Datenbank, den Uploads und den Hilfsdiensten, die dazugehören.

Backups

Easy Backup sichert die MySQL-Datenbank und die Uploads deines Backends nach Zeitplan oder auf Abruf und stellt einzelne Sicherungen wieder her.

Betrieb

Nach dem ersten Deployment geht es darum, Fehler früh zu sehen, Releases nachzuvollziehen und im Zweifel auf den letzten funktionierenden Stand zurückzugehen.

Erweitert

Danke für deine Anfrage

Wir haben deine Anfrage erhalten und melden uns schnellstmöglich bei dir.

Du möchtest direkt mit uns sprechen?

Buche hier einen passenden Termin für ein Erstgespräch mit Robin.

Kalender in einem neuen Tab öffnen