neos / neos-ui
Neos CMS UI written in React
Fund package maintenance!
shop.neos.io/neosfunding
Installs: 830 822
Dependents: 90
Suggesters: 0
Security: 0
Stars: 265
Watchers: 21
Forks: 135
Open Issues: 287
Language:JavaScript
Type:neos-package
Requires
- neos/neos: ^9.0.0 || 9.0.x-dev
- neos/neos-ui-compiled: 9.0.0-beta15
- 9.0.x-dev
- 9.0.0-beta15
- 9.0.0-beta14
- 9.0.0-beta13
- 9.0.0-beta12
- 9.0.0-beta11
- 9.0.0-beta10
- 9.0.0-beta8
- 9.0.0-beta3
- 9.0.0-beta2
- 9.0.0-beta1
- 8.4.x-dev
- 8.3.x-dev
- 8.3.11
- 8.3.10
- 8.3.9
- 8.3.8
- 8.3.7
- 8.3.6
- 8.3.5
- 8.3.4
- 8.3.3
- 8.3.2
- 8.3.1
- 8.3.0
- 8.2.x-dev
- 8.2.14
- 8.2.13
- 8.2.12
- 8.2.11
- 8.2.10
- 8.2.9
- 8.2.8
- 8.2.7
- 8.2.6
- 8.2.5-beta2
- 8.2.5-beta1
- 8.2.4
- 8.2.3
- 8.2.2
- 8.2.2-beta1
- 8.2.1
- 8.2.1-beta2
- 8.2.1-beta1
- 8.2.0
- 8.2.0-beta8
- 8.2.0-beta7
- 8.2.0-beta2
- 8.2.0-beta1
- 8.1.x-dev
- 8.1.14
- 8.1.13
- 8.1.12
- 8.1.11
- 8.1.10
- 8.1.9
- 8.1.8
- 8.1.7
- 8.1.6
- 8.1.5
- 8.1.4
- 8.1.3
- 8.1.2
- 8.1.1
- 8.1.0
- 8.0.x-dev
- 8.0.17
- 8.0.16
- 8.0.15
- 8.0.14
- 8.0.13
- 8.0.12
- 8.0.11
- 8.0.10
- 8.0.9
- 8.0.8
- 8.0.7
- 8.0.6
- 8.0.5
- 8.0.4
- 8.0.3
- 8.0.2
- 8.0.1
- 8.0.0
- 7.3.x-dev
- 7.3.22
- 7.3.21
- 7.3.20
- 7.3.19
- 7.3.18
- 7.3.17
- 7.3.15
- 7.3.14
- 7.3.12
- 7.3.11
- 7.3.10
- 7.3.9
- 7.3.8
- 7.3.7
- 7.3.6
- 7.3.5
- 7.3.4
- 7.3.3
- 7.3.2
- 7.3.1
- 7.3.0
- 7.2.x-dev
- 7.2.8
- 7.2.7
- 7.2.6
- 7.2.5
- 7.2.4
- 7.2.3
- 7.2.2
- 7.2.1
- 7.2.0
- 7.1.x-dev
- 7.1.10
- 7.1.9
- 7.1.8
- 7.1.7
- 7.1.6
- 7.1.5
- 7.1.4
- 7.1.3
- 7.1.2
- 7.1.1
- 7.1.0
- 7.0.x-dev
- 7.0.12
- 7.0.11
- 7.0.10
- 7.0.9
- 7.0.8
- 7.0.7
- 7.0.6
- 7.0.5
- 7.0.4
- 7.0.3
- 7.0.2
- 7.0.1
- 7.0.0
- 5.3.x-dev
- 5.3.18
- 5.3.17
- 5.3.16-beta1
- 5.3.15
- 5.3.14
- 5.3.13
- 5.3.12
- 5.3.11
- 5.3.10
- 5.3.9
- 5.3.8
- 5.3.7
- 5.3.6
- 5.3.5
- 5.3.4
- 5.3.3
- 5.3.2
- 5.3.1
- 5.3.0
- 5.2.x-dev
- 5.2.9
- 5.2.8
- 5.2.7
- 5.2.6
- 5.2.5
- 5.2.4
- 5.2.3
- 5.2.2
- 5.2.1
- 5.2.0
- 5.1.x-dev
- 5.1.13
- 5.1.12
- 5.1.11
- 5.1.10
- 5.1.9
- 5.1.8
- 5.1.7
- 5.1.6
- 5.1.5
- 5.1.4
- 5.1.3
- 5.1.2
- 5.1.1
- 5.1.0
- 5.0.x-dev
- 5.0.13
- 5.0.12
- 5.0.11
- 5.0.10
- 5.0.9
- 5.0.8
- 5.0.7
- 5.0.6
- 5.0.5
- 5.0.4
- 5.0.3
- 5.0.2
- 5.0.1
- 5.0.0
- 4.0.x-dev
- 4.0.14
- 4.0.13
- 4.0.12
- 4.0.11
- 4.0.10
- 4.0.9
- 4.0.8
- 4.0.7
- 4.0.6
- 4.0.5
- 4.0.4
- 4.0.3
- 4.0.2
- 4.0.1
- 4.0.0
- 3.x-dev
- 3.8.1
- 3.8.0
- 3.7.0
- 3.6.1
- 3.6.0
- 3.5.0
- 3.4.0
- 3.3.0
- 3.2.1
- 3.1.0
- 3.0.2
- 3.0.1
- 3.0.0
- 2.x-dev
- 2.9.2
- 2.9.1
- 2.9.0
- 2.8.1
- 2.8.0
- 2.7.0
- 2.6.1
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.0
- 2.2.1
- 2.2.0
- 2.1.0
- 2.0.2
- 2.0.1
- 2.0.0
- 1.x-dev
- 1.4.1
- 1.4.0
- 1.4.0-beta
- 1.3.4
- 1.3.3
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.14
- v1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 1.0.9
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.0-beta8
- 1.0.0-beta6
- 1.0.0-beta5
- 1.0.0-beta4
- 1.0.0-beta3
- 1.0.0-beta2
- 1.0.0-beta1
- 1.0.0-beta0
- 0.0.1
- v0.0.0
- dev-bugfix/references-on-copy
- dev-feature/3732-cr-privileges
- dev-90-fix-cut-copy-paste-across-dimensions
- dev-backport-e2e-tests
- dev-feature/3771-support-finding-nodes-by-id
- dev-bugfix/3839-ckeditor-warn-dialog-before-formatting-getting-lost-__build__
- dev-bugfix/3839-ckeditor-warn-dialog-before-formatting-getting-lost
- dev-bugfix/2092-resolve-resource-uris-on-server
- dev-feature/multi-app/02-loosen-the-menu
- dev-bugfix/optimise-ui-flowqueries
- dev-task/centralize-i18n
- dev-task/centralize-error-handling
- dev-userWorkspaces
- dev-workspaceAdjustments
- dev-3587-defaultRelationDistributionStrategy
- dev-bugfix/valueObjectSupportInNodePropertyConverterService
- dev-bugfix/3477-infinite-loading-indicator
- dev-bugfix/explicitValueObjectSupportForNodeProperties
- dev-feature/seriousCkInlineMode
- dev-feature/inspectorDefaultGroup
- dev-feature/workspaceSync
- dev-bugfix/3556/show-resize-icon-on-safari
- dev-task/3118/remove-plow-js
- dev-4549-separateReferencesAndProperties
- dev-task/90-remove-nodetypemanager-from-node-4515
- dev-catchEmptyNodeNames
- dev-nodeTypeFallbackHandling
- dev-bugfix/editorWithImplausibleValue
- dev-bugfix/3531-nodeCreationDialogPreventAccidentalClose
- dev-bugfix/3520-selectbox-current-value-doesnt-match-options
- dev-90-replace-node-inbackend-usage
- dev-task/makee2eTestsMoreIsolated
- dev-task/improveDocumentTitleNodeCreationHandler
- dev-feature/fallbackToRawModeForContents
- dev-90-performance-speedup-during-individual-publish
- dev-bugfix/resolve-testing-errors
- dev-feature/improved-tree
- dev-refactor-ts-insert-mode-selector
- dev-feature/node-creation-dialog-icons
- dev-90/editPreviewModeSupport
- dev-bugfix-3391-creation-dialog-time-now
- dev-rb/react-ui-components-ts-rewrite--toggable-panel
- dev-task/remove-legacy-editor-name-support
- dev-feature/esbuild-yarn-pnp
- dev-feature/yarn-pnp-mode
- dev-task/increase-node-version
- dev-dependabot/npm_and_yarn/eventsource-1.1.2
- dev-90-simplify-nodetypeconstraints
- dev-bugfix/use-flush-by-tags-in-neos-8
- dev-mhsdesign-docs-component-wiring
- dev-feature-add-custom-error-messages
- dev-dimaip-more-browsers
- dev-bugfix/error-after-discard-all-when-editing
- dev-fix/2922-cache
- dev-task/remove-resolveshortcuts-use
This package is auto-updated.
Last update: 2024-11-01 14:11:24 UTC
README
The Neos CMS interface written in ReactJS and a ton of other fun technology.
Versioning
This repository follows the same versioning scheme as Neos itself. Release roadmap is available here
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
- 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
- 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
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!
Features
- Blazingly fast Yarn 3 + ESbuild stack
- https://www.neos.io/features/editing-content.html
- https://www.neos.io/features/inline-editing-true-wysiwyg.html
Installation and usage
The UI is already included in the base Neos distribution.
And on Packagist available via: neos/neos-ui
Updating
composer update neos/neos-ui
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
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
To install the source files and setup git, run:
composer require neos/neos-ui-compiled:8.4.x-dev neos/neos-ui:8.4.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
-
Ensure you have the relevant version installed (see above).
-
Please install Docker for Windows.
-
Run
docker-compose up
. -
Inside
Configuration/Settings.yaml
, set the following property for disabling the pre-compiled files:
Neos: Neos: Ui: frontendDevelopmentMode: true
- Get an overview about the codebase. We've recorded an introduction on YouTube which gets you acquainted with the basics. Additionally, please get in touch with us on Slack in the channel #project-ui-rewrite. We're eager to help you get started!
on OSX / Linux
In order to start contributing on OSX / Linux, follow the following steps:
-
Ensure you have the relevant version installed (see above).
-
We require Chrome as well as the
yarn
(https://yarnpkg.com/en/) command and GNU Make(https://www.gnu.org/software/make/) to be installed on your system. -
The currently supported version of
node
is defined in.nvmrc
file. If you have nvm installed, you can just runnvm install && nvm use
from the project directory. -
Inside
Configuration/Settings.yaml
, set the following property for disabling the pre-compiled files:
Neos: Neos: Ui: frontendDevelopmentMode: true
- Run the initialization script:
make setup
- Get an overview about the codebase. We've recorded an introduction on YouTube which gets you acquainted with the basics. Additionally, please get in touch with us on Slack in the channel #project-ui-rewrite. We're eager to help you get started!
Guideline for PR and commit messages
Please see our guideline on how to write meaningful descriptions for your contributions.
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
Writing unit tests
The unit tests are executed with 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
To setup end-to-end tests locally you have got to do the same things described in CircleCI workflow, namely take the test disribution 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 (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
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 the1Dimension
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 <browser> <testFile> <optional flags>
- for example, this runs all tests in chrome: (NOTE starting with Chrome 127, --disable-search-engine-choice-screen is needed until DevExpress/testcafe#8248 is released)
yarn run testcafe chrome:--disable-search-engine-choice-screen 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
- for example, this runs all tests in chrome: (NOTE starting with Chrome 127, --disable-search-engine-choice-screen is needed until DevExpress/testcafe#8248 is released)
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
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
see LICENSE