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(3mo ago)2681.1M—5.6%151[251 issues](https://github.com/neos/neos-ui/issues)[57 PRs](https://github.com/neos/neos-ui/pulls)20GPL-3.0-or-laterTypeScript Since Oct 14Pushed 3d 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 today READMEChangelog (10)Dependencies (4)Versions (627)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.#### 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. #### E2E tests with Playwright & Docker [](#e2e-tests-with-playwright--docker) E2E tests use [Playwright](https://playwright.dev) with [playwright-bdd](https://vitalets.github.io/playwright-bdd/) for Gherkin scenarios and run against a Dockerised Neos instance — no local Neos installation needed. See [`Tests/E2E/README.md`](./Tests/E2E/README.md) for full details. **Prerequisites:** Docker, Node.js ≥ 24, make **Quick start:** ``` cd Tests/E2E make setup # build SUT image, install deps, generate test files make test # run all tests (auto-starts and tears down the SUT) ``` **During development** — keep the SUT running for a faster feedback loop: ``` make start-sut # start SUT in the background (localhost:8081) REUSE_EXISTING_SUT=1 npm run test -- --grep "My feature" # run without rebooting make test-ui # interactive Playwright UI make enter-sut # bash shell inside the SUT container make log-sut # stream SUT logs make sut-down # stop containers and delete volumes ``` **Writing tests:** add a `.feature` file under `Tests/E2E/features/` and a matching `*.steps.ts` under `Tests/E2E/steps/`. After editing feature files run `make generate-bdd-files` (done automatically by `make setup` and `make test`). ##### Debugging integration tests [](#debugging-integration-tests) - The GitHub action is uploading artefacts that can be downloaded as a zip file, e.g. Artifact download URL: #### 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 68 — FairBetter than 99% of packages Maintenance72 Regular maintenance activity Popularity60 Solid adoption and visibility Community49 Growing community involvement Maturity83 Battle-tested with a long release history Bus Factor5 5 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 553 Last Release 2d ago Major Versions 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.3 → 9.0.82026-03-18 8.4.x-dev → 9.2.0-beta12026-06-30 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 (1045 commits)")[![skurfuerst](https://avatars.githubusercontent.com/u/190777?v=4)](https://github.com/skurfuerst "skurfuerst (993 commits)")[![markusguenther](https://avatars.githubusercontent.com/u/1014126?v=4)](https://github.com/markusguenther "markusguenther (906 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)")[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (436 commits)")[![weblate](https://avatars.githubusercontent.com/u/1607653?v=4)](https://github.com/weblate "weblate (406 commits)")[![kitsunet](https://avatars.githubusercontent.com/u/324408?v=4)](https://github.com/kitsunet "kitsunet (197 commits)")[![kdambekalns](https://avatars.githubusercontent.com/u/95873?v=4)](https://github.com/kdambekalns "kdambekalns (144 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)")[![danielkestler](https://avatars.githubusercontent.com/u/3976405?v=4)](https://github.com/danielkestler "danielkestler (88 commits)")[![JamesAlias](https://avatars.githubusercontent.com/u/1615332?v=4)](https://github.com/JamesAlias "JamesAlias (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)")[![ahaeslich](https://avatars.githubusercontent.com/u/1756367?v=4)](https://github.com/ahaeslich "ahaeslich (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 [neos/demo Site package for the Neos Demo Site 18188.3k10](/packages/neos-demo)[neos/neos-base-distribution Neos Base Distribution 4366.0k](/packages/neos-neos-base-distribution)[neos/redirecthandler-ui This package provides a backend module to manage Neos.RedirectHandler redirects 13609.1k5](/packages/neos-redirecthandler-ui)[neos/seo SEO configuration and tools for Neos 141.0M31](/packages/neos-seo)[neos/form-builder Flow Form Framework integration into Neos CMS 19364.6k20](/packages/neos-form-builder)[sandstorm/neostwofactorauthentication 1327.0k](/packages/sandstorm-neostwofactorauthentication) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)