Preparation

Working locally on your project

Set up your own machine for working on platform projects – ready in minutes with the setup app.

On this page

The fastest path to a local development environment is the setup app: it installs all required tools, clones your project repositories, and connects them with your IDE.

How to proceed

  1. Check the requirements – what your machine needs and what the setup app installs for you.
  2. Download the setup app, sign in, and run the developer setup.
  3. Select your project in the setup app and clone it – all repositories land in your workspace folder (default: ~/Documents/application-platform).
  4. Open the project in your IDE and start the application:
ap run-local
Tip
Don’t want to install anything? Work with a remote workspace instead – a ready-made development VM in the cloud.

What’s inside the workspace folder

The setup app clones all repositories of a project as siblings into one shared folder and links the shared IDE/AI configuration from the local-configuration repository:

application-platform/<organization>/<project>/
├── backend/                # your application repositories
├── <app>/
├── local-configuration/    # central IDE and AI agent configuration
├── .cursor → local-configuration/.cursor      (symlink)
├── AGENTS.md → local-configuration/AGENTS.md  (symlink)
└── …

This way the same editor settings and AI instructions apply to all repositories of the project.

See also