Preparation

Working With Projects

How to start repositories and work with generated projects inside the Workspace VM.

On this page

The Workspace VM is designed for several project repositories next to each other. Open the shared group folder so backend, frontends, and homepages are visible together.

Start a project

Every generated app repository includes a dev script:

ap run-local

The script starts the application with the right local settings. Frontends and homepages use fixed, incremented ports so several applications can run in parallel.

Commit changes

The Workspace VM clones project repositories on the main branch by default. Work there as you would locally: create feature branches, verify changes, commit, and push.

CI runs on main (versioning, builds, GitOps updates). Feature branches produce dynamic build versions without a version commit in the repository.

The Workspace VM does not replace review; it provides a consistent development environment.