PHPackages neos/neos-ui - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Admin Panels](/categories/admin) 4. / 5. neos/neos-ui ActiveNeos-package[Admin Panels](/categories/admin) neos/neos-ui ============ Neos CMS UI written in React 9.1.5(2mo ago)2661.0M↑11%146[134 issues](https://github.com/neos/neos-ui/issues)[56 PRs](https://github.com/neos/neos-ui/pulls)20GPL-3.0-or-laterTypeScriptCI passing Since Oct 14Pushed 1mo ago19 watchersCompare [ Source](https://github.com/neos/neos-ui)[ Packagist](https://packagist.org/packages/neos/neos-ui)[ Fund](https://shop.neos.io/neosfunding/)[ RSS](/packages/neos-neos-ui/feed)WikiDiscussions 9.2 Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (622)Used By (20) @neos/neos-ui ============= [](#neosneos-ui) [![CircleCI](https://camo.githubusercontent.com/538d67a656f14d82e4701c6e32033fc74ef5f879a84fe000b2d2fb5ff7d7a6c6/68747470733a2f2f636972636c6563692e636f6d2f67682f6e656f732f6e656f732d75692e7376673f7374796c653d737667)](https://circleci.com/gh/neos/neos-ui) [![Known Vulnerabilities](https://camo.githubusercontent.com/e55fdb3b7e8c7baea2c271e425d04b6b9a7ce1882d53d976e39be23bba7e5025/68747470733a2f2f736e796b2e696f2f746573742f6769746875622f6e656f732f6e656f732d75692f62616467652e7376673f74617267657446696c653d7061636b6167652e6a736f6e)](https://snyk.io/test/github/neos/neos-ui?targetFile=package.json)[![Slack](https://camo.githubusercontent.com/42ad2f6d35233a19366075afa9baab531802e447a6740cc2d880155b614b2063/687474703a2f2f736c61636b2e6e656f732e696f2f62616467652e737667)](http://slack.neos.io) [![Forum](https://camo.githubusercontent.com/0470ed7585c24074b5d912601b0f7f69efe4ab815e6a8591304e04f3f68e8a37/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666f72756d2d446973636f757273652d3339633666662e737667)](https://discuss.neos.io/) [![Twitter](https://camo.githubusercontent.com/cd24d3bac83a75c677d2ad6631f1a4ef01789cb5c341f1d75b589c25851d349b/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f6e656f73636d732e7376673f7374796c653d736f6369616c)](https://twitter.com/NeosCMS) > The Neos CMS interface written in ReactJS and a ton of other fun technology. Versioning ---------- [](#versioning) This repository follows the same versioning scheme as Neos itself. Release roadmap is [available here](https://www.neos.io/features/release-process.html) That means: - All bugfixes go to the lowest maintained branch - All new features go only to the 8.4 and 9.0 branch - New minor and major releases are made in sync with Neos/Flow. Bugfix releases may be available independently ### Currently maintained versions [](#currently-maintained-versions) - NeosCMS version 8.3: branch 8.3 - NeosCMS version 8.3: branch 8.4 - NeosCMS version 9.0: branch 9.0 - latest development happens currently in the 8.4 and 9.0 branch #### Releases with just security updates [](#releases-with-just-security-updates) - NeosCMS version 7.3: branch 7.3 - NeosCMS version 8.0: branch 8.0 - NeosCMS version 8.1: branch 8.1 - NeosCMS version 8.2: branch 8.2 Browser support --------------- [](#browser-support) The new interface supports all evergreen (i.e. self-updating) browsers, including: **Chrome, Firefox, Safari, Edge, Opera and other webkit-based browsers**. If you discover bugs in any of the supported browsers, please [report them](https://github.com/neos/neos-ui/issues/new)! Features -------- [](#features) - Blazingly fast Yarn 3 + ESbuild stack - - Installation and usage ---------------------- [](#installation-and-usage) The UI is [already included](https://github.com/neos/neos-base-distribution/blob/3.3/composer.json#L24) in the base Neos distribution. And on Packagist available via: `neos/neos-ui` ### Updating [](#updating) ``` composer update neos/neos-ui ``` ### Installing latest development [](#installing-latest-development) For trying out the new UI, we recommend you to run the regularly released beta releases. However, if you want to stay on bleeding-edge, or want to help out developing, you'll need the `9.0.x-dev` release. You can install the latest release using: ``` composer require neos/neos-ui-compiled:9.0.x-dev neos/neos-ui:9.0.x-dev ``` Contributing ------------ [](#contributing) Please follow the respective guides for contributing on OSX and on Linux. To start developing the Neos Ui you will need a running Neos instance locally. You can use - one of your own, local Neos 8.3 instances, - create a new one with `composer create-project neos/neos-base-distribution neos-ui-development-instance`, - or use the docker compose setup in this repository (see instructions below). ### Setup Source Files and Git [](#setup-source-files-and-git) To install the source files and setup git, run: ``` composer require neos/neos-ui-compiled:9.0.x-dev neos/neos-ui:9.0.x-dev --prefer-source ``` This will sync the git repository of Neos Ui into `Packages/Application/Neos.Neos.Ui` (this might take a while). To push your changes to GitHub you need to fork the Neos Ui and change the git remote to your fork (check with `git remove -v`). Run `make setup`. To check what commands are executed have a look at the `Makefile` in the root of this repository. ### on Windows [](#on-windows) 1. Ensure you have the relevant version installed (see above). 2. Please install Docker for Windows. 3. Run `docker-compose up`. 4. Inside `Configuration/Settings.yaml`, set the following property for disabling the pre-compiled files: ``` Neos: Neos: Ui: frontendDevelopmentMode: true ``` 6. Get an overview about the codebase. We've recorded [an introduction on YouTube](https://www.youtube.com/watch?v=RYBUS5Nxxxk) which gets you acquainted with the basics. Additionally, please get in touch with us on [Slack](http://slack.neos.io) in the channel #project-ui-rewrite. We're eager to help you get started! ### on OSX / Linux [](#on-osx--linux) In order to start contributing on OSX / Linux, follow the following steps: 1. Ensure you have the relevant version installed (see above). 2. We require [Chrome](https://www.google.com/chrome/browser/desktop/index.html) as well as the `yarn`() command and GNU Make() to be installed on your system. 3. The currently supported version of `node` is defined in `.nvmrc` file. If you have [nvm](https://github.com/creationix/nvm) installed, you can just run `nvm install && nvm use` from the project directory. 4. Inside `Configuration/Settings.yaml`, set the following property for disabling the pre-compiled files: ``` Neos: Neos: Ui: frontendDevelopmentMode: true ``` 5. Run the initialization script: ``` make setup ``` 6. Get an overview about the codebase. We've recorded [an introduction on YouTube](https://www.youtube.com/watch?v=RYBUS5Nxxxk) which gets you acquainted with the basics. Additionally, please get in touch with us on [Slack](http://slack.neos.io) in the channel #project-ui-rewrite. We're eager to help you get started! #### Guideline for PR and commit messages [](#guideline-for-pr-and-commit-messages) Please see [our guideline](https://neos.readthedocs.io/en/latest/Contribute/Documentation/BeginnersGuide.html#guideline-commit-messages)on how to write meaningful descriptions for your contributions. #### Doing upmerges [](#doing-upmerges) To do the upmerge run the following commands ``` # review and `git commit` git checkout 8.0 && git fetch && git reset --hard origin/8.0 && git merge --no-ff --no-commit origin/7.3 # review and `git commit` git checkout 8.1 && git fetch && git reset --hard origin/8.1 && git merge --no-ff --no-commit origin/8.0 # review and `git commit` git checkout 8.2 && git fetch && git reset --hard origin/8.2 && git merge --no-ff --no-commit origin/8.1 # review and `git commit` git checkout 8.3 && git fetch && git reset --hard origin/8.3 && git merge --no-ff --no-commit origin/8.2 # review and `git commit` git checkout 8.4 && git fetch && git reset --hard origin/8.4 && git merge --no-ff --no-commit origin/8.3 # review and `git commit` git checkout 9.0 && git fetch && git reset --hard origin/9.0 && git merge --no-ff --no-commit origin/8.4 # review and `git commit` ``` #### Development commands [](#development-commands) CommandDescription`make clean`delete all node\_modules in every subdirectory.`make build`Runs the development build for neos-ui once.`make build-watch`Starts a watcher process, which automatically runs a build for neos-ui, everytime a resource file (like JavaScript and CSS) changes.`make lint`Executes `make lint-js` and `make lint-editorconfig`.`make lint-js`Runs test in all subpackages.`make lint-editorconfig`Tests if all files respect the `.editorconfig`.`make test`Executes the test on all source files.`make test-e2e`Executes integration tests.#### Writing unit tests [](#writing-unit-tests) The unit tests are executed with [jest](https://facebook.github.io/jest/). To run the unit tests, execute `make test` in your shell. Adding unit tests is fairly simple, just create a file on the same tree level as your changed/new feature, named `[filename].spec.js` and karma will execute all tests found within the spec file, other than that, just orient yourself on the existing tests. Use `it.only(() => {})` and `describe.only(() => {})` if you want to run a specific test and not the whole test suite. #### Integration tests [](#integration-tests) To setup end-to-end tests locally you have got to do the same things described in [CircleCI workflow](https://github.com/neos/neos-ui/blob/8.3/.circleci/config.yml), namely take the [test disribution](https://github.com/neos/neos-ui/blob/8.3/Tests/IntegrationTests/TestDistribution/composer.json) and `composer install` in it, put the right branch into Neos.Neos.Ui folder and run webserver and mysql server with the same config as described in the test distribution's [Settings.yaml](https://github.com/neos/neos-ui/blob/8.3/Tests/IntegrationTests/TestDistribution/Configuration/Settings.yaml) (or adjust it). For executing the end to end tests on a Mac with catalina or higher you need to permit screen recording. Open 'System Preferences > Security & Privacy > Privacy > Screen Recording' and check 'TestCafe Browser Tools' in the application list. ``` make test-e2e-docker ``` #### Local Development with e2e-tests & docker [](#local-development-with-e2e-tests--docker) To speed up the e2e-test workflow/feedback loop you can start the system under test in a docker setup and run the tests against that: - `make start-neos-dev-instance` (starts a docker setup with the system under test and keep it running - in the `1Dimension` scenario) - The neos dev instance is available at `localhost:8081` - To enter the container run `docker compose -f Tests/IntegrationTests/docker-compose.neos-dev-instance.yaml exec php bash` - `yarn run testcafe ` - for example, this runs all tests in chrome: `yarn run testcafe chrome Tests/IntegrationTests/Fixtures/1Dimension` - some helpful optional flags are - `-T 'sidebars'` - grep tests by pattern and only execute those - `--selector-timeout=10000` - if you work on async pieces of the UI then this might help to prevent race conditions - `--assertion-timeout=30000` - see above - `--debug-on-fail` - you can debug the state of the app at the moment an assertion failed ##### Debugging integration tests [](#debugging-integration-tests) - View the recording via Sauce Labs. You can find the url in the beginning of the test output. - Observe Flow exceptions and logs in build artifacts. - You can trigger a SSH enabled build via the CircleCI interface and then login. #### Releasing [](#releasing) You only need to trigger the jenkins release with the version you want to release. After jenkins has finished you need release a new version on github. License ------- [](#license) see [LICENSE](./LICENSE) ### Health Score 69 — FairBetter than 100% of packages Maintenance78 Regular maintenance activity Popularity59 Moderate usage in the ecosystem Community49 Growing community involvement Maturity83 Battle-tested with a long release history Bus Factor4 4 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~7 days Total 552 Last Release 54d ago Major Versions 8.3.16 → 9.0.22025-09-26 8.4.0 → 9.0.32025-10-29 8.4.1 → 9.1.12025-12-19 8.4.2 → 9.0.72026-02-26 8.4.x-dev → 9.0.82026-03-18 PHP version history (3 changes)2.1.1PHP >=5.5.0 3.0.3PHP ~7.0 4.3.0PHP ^7.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/11575267?v=4)[Neos](/maintainers/neos)[@neos](https://github.com/neos) --- Top Contributors [![dimaip](https://avatars.githubusercontent.com/u/837032?v=4)](https://github.com/dimaip "dimaip (1334 commits)")[![grebaldi](https://avatars.githubusercontent.com/u/2522299?v=4)](https://github.com/grebaldi "grebaldi (1071 commits)")[![mhsdesign](https://avatars.githubusercontent.com/u/85400359?v=4)](https://github.com/mhsdesign "mhsdesign (1034 commits)")[![skurfuerst](https://avatars.githubusercontent.com/u/190777?v=4)](https://github.com/skurfuerst "skurfuerst (986 commits)")[![markusguenther](https://avatars.githubusercontent.com/u/1014126?v=4)](https://github.com/markusguenther "markusguenther (896 commits)")[![Inkdpixels](https://avatars.githubusercontent.com/u/1557092?v=4)](https://github.com/Inkdpixels "Inkdpixels (876 commits)")[![mstruebing](https://avatars.githubusercontent.com/u/12071529?v=4)](https://github.com/mstruebing "mstruebing (543 commits)")[![weblate](https://avatars.githubusercontent.com/u/1607653?v=4)](https://github.com/weblate "weblate (404 commits)")[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (387 commits)")[![kitsunet](https://avatars.githubusercontent.com/u/324408?v=4)](https://github.com/kitsunet "kitsunet (190 commits)")[![kdambekalns](https://avatars.githubusercontent.com/u/95873?v=4)](https://github.com/kdambekalns "kdambekalns (143 commits)")[![greenkeeperio-bot](https://avatars.githubusercontent.com/u/14790466?v=4)](https://github.com/greenkeeperio-bot "greenkeeperio-bot (136 commits)")[![pKallert](https://avatars.githubusercontent.com/u/91674611?v=4)](https://github.com/pKallert "pKallert (110 commits)")[![johannessteu](https://avatars.githubusercontent.com/u/769789?v=4)](https://github.com/johannessteu "johannessteu (105 commits)")[![JamesAlias](https://avatars.githubusercontent.com/u/1615332?v=4)](https://github.com/JamesAlias "JamesAlias (88 commits)")[![danielkestler](https://avatars.githubusercontent.com/u/3976405?v=4)](https://github.com/danielkestler "danielkestler (88 commits)")[![daniellienert](https://avatars.githubusercontent.com/u/642226?v=4)](https://github.com/daniellienert "daniellienert (53 commits)")[![bwaidelich](https://avatars.githubusercontent.com/u/307571?v=4)](https://github.com/bwaidelich "bwaidelich (43 commits)")[![dfeyer](https://avatars.githubusercontent.com/u/221173?v=4)](https://github.com/dfeyer "dfeyer (39 commits)")[![gerhard-boden](https://avatars.githubusercontent.com/u/10533739?v=4)](https://github.com/gerhard-boden "gerhard-boden (38 commits)") --- Tags content-managementhacktoberfestimmutablejsreactjsreduxredux-saga ### Embed Badge ![Health badge](/badges/neos-neos-ui/health.svg) ``` [![Health](https://phpackages.com/badges/neos-neos-ui/health.svg)](https://phpackages.com/packages/neos-neos-ui) ``` ### Alternatives [dmstr/yii2-adminlte-asset AdminLTE backend theme asset bundle for Yii 2.0 Framework 1.1k1.8M67](/packages/dmstr-yii2-adminlte-asset)[dwij/laraadmin LaraAdmin is a Open source Laravel Admin Panel / CMS which can be used as Admin Backend, Data Management Tool or CRM boilerplate for Laravel with features like CRUD Generation, Module Manager, Media, Menus, Backups and much more 1.6k68.7k](/packages/dwij-laraadmin)[filament/spatie-laravel-media-library-plugin Filament support for `spatie/laravel-medialibrary`. 1764.8M125](/packages/filament-spatie-laravel-media-library-plugin)[neos/demo Site package for the Neos Demo Site 18181.0k6](/packages/neos-demo)[filament/infolists Easily add beautiful read-only infolists to any Livewire component. 1220.8M36](/packages/filament-infolists)[neos/redirecthandler-ui This package provides a backend module to manage Neos.RedirectHandler redirects 13578.9k5](/packages/neos-redirecthandler-ui) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)