Documentation: Dev setup for the Neos/MediaUi sprint 2026 🇨🇭

[mhsdesign]

General setup guidance for the sprint.

Other information about the sprint is available on discuss: https://discuss.neos.io/t/neos-sprint-rotkreuz-switzerland-april-13th-until-april-17th-2026/6897

To ensure we can productively start the week we highly recommend having a Neos development setup already. That means installing a Neos.Demo just with the development versions of Neos and Flow.

We currently maintain two different architectures that differ fundamentally:

1. non event sourced Neos <=8.4 and media-ui 2.x
2. event sourced Neos >=9.0 and media-ui 3.x

Depending what you're planning on working on will you be working with one or the other or maybe both Neos versions.

1. media-ui 2.x: Development of general bugfixes and minor features that can be upmerged to 3.x
2. media-ui 3.x: Development of 3.x bugfixes and major features

Setup

This setup guide assumes you know how to handle your local dev stack - choose whatever you are most comfortable with e.g. ddev, docker, local etc. You need php, composer and node and yarn - the usual:)

Otherwise here you'll find documentation how to setup Neos projects: https://docs.neos.io/guide/installation-development-setup

Setup Neos dev-collection with media-ui

1.) Clone the repo via git or use composer create-project:

For Neos 8.3-dev with media-ui 2.x use:

git clone https://github.com/neos/neos-development-distribution.git --depth 1 --branch 8.3

For Neos 9.1-dev with media-ui 3.x use:

git clone https://github.com/neos/neos-development-distribution.git --depth 1 --branch 9.1

2.) Add the media ui

composer require flowpack/media-ui

(note that the development distribution ensures that neos and flowpack vendors are always installed by source, otherwise --prefer-source must be used)

3.) Install Neos with composer and get flow running (your preferred method).

4.) Follow all further setup steps see ./flow setup

Building the media-ui

Navigate to the installation directory of the media-ui: Packages/Application/Flowpack.Media.Ui

Use node 22 and install with yarn:

yarn

Now you can build the module via

yarn build

Make a test change and see if the changes are reflected.

More details on the available commands for development can be found in the repo: https://github.com/Flowpack/media-ui/tree/main

[olimination]

@mhsdesign Shouldn't the git clone command use --branch X.Y instead of --base X.Y?
e.g.
Instead of:
git clone https://github.com/neos/neos-development-distribution.git --depth 1 --base 8.3

it should be:
git clone https://github.com/neos/neos-development-distribution.git --depth 1 --branch 8.3

because my git cli does not know the option --base

[mhsdesign]

Thanks well spotted, i adjusted it. My brain must have mixed it up with the github pr filter option base:9.0 ;)