# Neues Projekt anlegen

Ein neues Projekt entsteht im Assistenten der Oberfläche oder als JSON über die ap CLI und die MCP-Werkzeuge des Agent-Plugins.

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

Aus Komponenten und Stack deines Produkts generiert die Plattform die GitLab-Gruppe mit allen Repositories.

## Im Assistenten der Oberfläche

Nach der Registrierung unter `app.application-platform.com/register` legst du über **Organisation erstellen** eine Organisation an. Der Projekt-Assistent fragt Komponenten (auch mehrere Apps), Tech-Stack je Komponente und optional Domains, Store-Accounts und Hosting ab; jeden Klick zeigt [Dein erstes Projekt anlegen]({{< relref "getting-started" >}}).

Unterstützt sind Flutter, React Native (Expo), Next.js, natives iOS und Android für Apps, Hugo und Astro für Homepages sowie NestJS, FastAPI und Laravel für Backends; Django, Vue oder Spring fehlen heute.

## Per CLI mit JSON

`demo-json` schreibt eine Vorlage, mit `--minimal` eine kürzere:

```bash
ap platform projects demo-json --minimal -o project.json
```

Eine Next.js-App mit NestJS-Backend und Datenbank sieht so aus:

```json
{
  "slug": "shop",
  "name": "Shop",
  "description": "Onlineshop mit Web-App und API",
  "hostingMode": "none",
  "deploymentMode": "standard",
  "repositories": [
    {
      "type": "app",
      "techStack": "nextjs",
      "name": "Web App",
      "configurationId": "web",
      "webProdDomain": "app.example.com",
      "webEnabled": true
    },
    {
      "type": "backend",
      "techStack": "nestjs",
      "name": "API",
      "backendUrl": "api.example.com",
      "hasDatabase": true,
      "smtpEnabled": false
    }
  ]
}
```

`type` und `techStack` entsprechen den Stacks des Assistenten, Packages (`dart-package`, `npm`, `go`, `docker-image` und weitere) sind zusätzlich möglich. Danach legst du das Projekt an, wartest mit `--watch` auf die Repositories und klonst sie:

```bash
ap platform projects create --from-json project.json --watch
ap platform projects clone shop
```

`clone` legt alle Repositories unter `~/Documents/application-platform/<organisations-slug>/shop/` ab, richtet die Git-Hooks ein und verlinkt `local-configuration`; `ap platform projects status <projekt-id>` zeigt den Stand einer laufenden Einrichtung.

## Per Agent

Mit dem [Agent-Plugin]({{< relref "cli-and-agent-plugin" >}}) reicht der Prompt „Lege ein neues Application-Platform-Projekt mit einer Next.js-App und einem NestJS-Backend an und klone es.“ Der Skill `create-project` ruft `platform_whoami` auf, holt mit `platform_projects_demo_json` (`minimal: true`) die Vorlage, passt `name`, `repositories[].type` und `techStack` an, ruft `platform_projects_create` auf, wartet mit `platform_watch` (Subjekt `project`) und klont mit `platform_projects_clone`. Bei mehreren Organisationen fragt der Agent nach, Mitgliedschaften lässt er leer, damit du Maintainer wirst, und schlägt Create oder Watch fehl, legt er nichts an der Plattform vorbei an.

## Was danach in GitLab liegt

Pro Komponente entsteht ein Repository mit Code-Gerüst, generierter `.gitlab-ci.yml` und `env/`-Dateien, dazu `local-configuration` (Editor- und Agent-Konfiguration), `gitops-configuration` (Deployment für Dev und Prod) und `gitlab-profile` (README der Gruppe); Sentry kommt hinzu, sobald unter **Anbindungen** ein Sentry-Konto verbunden ist. Danach öffnest du den Projektordner im Editor und startest jede Anwendung mit `ap run-local`, siehe [Lokal entwickeln]({{< relref "local-development" >}}).