# Schnellstart

In vier Schritten auf die Plattform: ap CLI installieren, Agent-Plugin hinzufügen, Projekt importieren oder anlegen, starten und veröffentlichen.

> Source: https://www.application-platform.com/de/docs/quickstart/

Die Plattform legt für dein Projekt Repositories, Pipelines und Deployments an. Du brauchst dafür die ap CLI und, wenn du mit Claude Code, Cursor oder Codex arbeitest, das Agent-Plugin.

**Prompt für deinen Agenten**

```text
Richte mich auf der Application Platform ein: 1. Prüfe mit `ap --version`, ob die ap CLI installiert ist; falls nicht, installiere sie mit `curl -fsSL https://www.application-platform.com/install.sh | sh` (Windows: `irm https://www.application-platform.com/install.ps1 | iex`). 2. Installiere das Agent-Plugin mit `npx --yes github:doppelt-digital/application-platform-plugin` und melde mich mit `ap login` an. 3. Liegt in diesem Ordner schon Code, importiere ihn mit platform_projects_import_local; sonst lege ein neues Projekt an (platform_projects_demo_json, platform_projects_create, platform_watch, platform_projects_clone). 4. Starte die Anwendung mit `ap run-local` und sage mir, wo der Arbeitsordner liegt.
```

## Voraussetzungen

- Ein [Account](https://app.application-platform.com/register) mit einer Organisation
- [Node.js 18 oder neuer](https://nodejs.org/)

## 1. ap CLI installieren und anmelden

macOS und Linux:

```bash
curl -fsSL https://www.application-platform.com/install.sh | sh
```

Windows (PowerShell):

```powershell
irm https://www.application-platform.com/install.ps1 | iex
```

Das Skript legt `ap` auf deinen PATH; öffne danach ein neues Terminal und melde dich an:

```bash
ap login
```

Wer den Rechner komplett einrichten lassen will (Runtimes, Editoren, Projekte), nimmt stattdessen die [Setup-App]({{< relref "/downloads" >}}), die die CLI mitbringt.

## 2. Agent-Plugin installieren

```bash
npx --yes github:doppelt-digital/application-platform-plugin
```

Der Installer erkennt Claude Code, Cursor und Codex, legt Skills und MCP-Server an und startet `ap login`. Danach lädst du den Editor neu. Für Agenten ohne MCP gibt es nur die Skills: `npx skills add doppelt-digital/application-platform-plugin -g -y`. Alle Wege stehen unter [CLI und Agent-Plugin]({{< relref "cli-and-agent-plugin" >}}).

## 3. Projekt importieren oder anlegen

**Bestehender Ordner**: Sag dem Agenten „Importiere dieses Projekt in meinen Application-Platform-Account.“ oder nutze die CLI im Projektordner:

```bash
ap platform projects import-local . "Mein Projekt"
```

Unterstützt werden Flutter, React Native (Expo), Next.js, natives iOS und Android, Hugo, Astro, NestJS, FastAPI und Laravel. Details: [Bestehendes Repository importieren]({{< relref "agent-project-import" >}}).

**Neues Projekt**: Sag dem Agenten „Lege ein neues Projekt mit einer Next.js-App und einem NestJS-Backend an und klone es.“ oder nutze die CLI:

```bash
ap platform projects demo-json --minimal -o project.json
ap platform projects create --from-json project.json --watch
ap platform projects clone <projekt-slug>
```

Ohne CLI legst du das Projekt im Assistenten unter **Projekte** in der [Web-Oberfläche](https://app.application-platform.com) an. Details: [Neues Projekt anlegen]({{< relref "create-project" >}}).

In beiden Fällen liegt das Projekt danach unter `~/Documents/application-platform/<organisation>/<projekt>/` mit einem Ordner pro Repository.

## 4. Starten und veröffentlichen

```bash
cd ~/Documents/application-platform/<organisation>/<projekt>/<repository>
ap run-local
```

Ein Push auf `main` startet die Pipeline und rollt auf Dev aus; Produktion gibst du in GitLab per Klick frei. Dafür braucht das Projekt einen [Server]({{< relref "servers" >}}) und für die eigene Adresse eine [Domain]({{< relref "domain" >}}). Den Ablauf beschreibt [Git-Workflow und Deployment]({{< relref "git-workflow" >}}).

## Wie es weitergeht

- Neu bei Git, Terminal und Servern: [Was ist die Application Platform?]({{< relref "what-is-the-platform" >}}) beginnt den Einsteiger-Pfad.
- Erfahren: [Überblick in fünf Minuten]({{< relref "developer-overview" >}}) und [Lokal entwickeln]({{< relref "local-development" >}}).
- Fertige Software wie WordPress oder n8n betreiben: [Docker Apps aus dem Katalog]({{< relref "hosted-apps" >}}).

