Create a new project

From the components and stack of your product, MainPath generates the git group with all repositories. The default is MainPath GitLab; at the bottom of the wizard you can choose GitHub or GitLab.com, see GitHub: credentials and GitLab: credentials.

In the wizard of the web interface

After registering at app.application-platform.com/register, you create an organization via Create organization. The project wizard asks for components (several apps if needed), the tech stack per component and, optionally, domains, store accounts and hosting; Create your first project shows every click.

Supported are Flutter, React Native (Expo), Next.js, native iOS and Android for apps, Hugo and Astro for homepages, and NestJS, FastAPI and Laravel for backends; Django, Vue or Spring are missing today.

Via the CLI with JSON

demo-json writes a template, and --minimal a shorter one:

mp platform projects demo-json --minimal -o project.json

A Next.js app with a NestJS backend and a database looks like this:

{
  "slug": "shop",
  "name": "Shop",
  "description": "Online shop with browser app and 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 and techStack match the wizard’s stacks, and packages (dart-package, npm, go, docker-image and others) are possible as well. Then create the project, wait with --watch for the repositories and clone them:

mp platform projects create --from-json project.json --watch
mp platform projects clone shop

clone places all repositories under ~/Documents/MainPath/<organization-slug>/shop/, installs the Git hooks and links local-configuration; mp platform projects status <project-id> shows the state of a running setup.

Via the agent

With the agent plugin the prompt “Create a new MainPath project with a Next.js app and a NestJS backend and clone it.” is enough. The create-project skill calls platform_whoami, fetches the template with platform_projects_demo_json (minimal: true), adjusts name, repositories[].type and techStack, calls platform_projects_create, waits with platform_watch (subject project) and clones with platform_projects_clone. If you belong to several organizations, the agent asks; it leaves memberships empty so that you become the maintainer, and if create or watch fails, it creates nothing outside MainPath.

What ends up in GitLab

Each component gets a repository with a code scaffold, a generated .gitlab-ci.yml and env/ files, alongside local-configuration (editor configuration), gitops-configuration (deployment for dev and prod) and gitlab-profile (group README); Sentry is added as soon as a Sentry account is connected under Connections. Then open the project folder in your editor and start each application with mp run-local, see Local development.