Aller au contenu principal
Jahia Store
FR

Jahia App-shell

supported
Télécharger 4.0.0

Informations

Identifiant du module
app-shell
Identifiant de groupe
org.jahia.modules
Statut
supported
Catégorie
Platform
Auteur
JSG
Site web du développeur
http://www.jahia.com
Nécessite Jahia
8.2.2.0
Publié le
2026-11-03
Source
scm:git:git@github.com:Jahia/app-shell.git

This appshell module provides shared dependencies for Jahia webpack application, enabling Jahia support for micro-frontends.

 

Versions

app-shell 4 updates the technical stack of the Jahia editing interfaces and opens the migration of UI extensions from webpack to Vite. Most changes concern developers of custom UI extensions. The migration guide gives the full procedure.

What you must do before you upgrade:

  • Every site: make sure your editors use Chrome or Edge 94, Firefox 93, Safari 16.4 or later.
  • If you maintain a custom UI extension (a module whose webpack.config.js contains ModuleFederationPlugin): follow the migration guide and test your extension on app-shell 4. Official Jahia modules need no action from you.

Breaking Changes

  • Raised the minimum browser versions for the Jahia editing interfaces to Chrome or Edge 94, Firefox 93 and Safari 16.4 (previously Chrome 60, Edge 44, Firefox 54 and Safari 12). 
  • Upgraded the libraries that the app-shell provides to UI extensions, some across major versions:
    • @jahia/ui-extender  from 1.3.0 to 2.0.0
    • i18next  from 19.9.2 to 23.16.8
    • react-i18next from 11.18.6 to 15.7.4
    • react-redux from 8.1.3 to 9.3.0
    • redux from 4.2.1 to 5.0.1
  • Removed i18next-xhr-backend, @apollo/react-common and @apollo/react-hooks from the libraries that the app-shell provides. 
  • Stopped sharing @jahia/moonstone as a single instance across UI extensions. 
  • Changed the Jahia dashboard pages to HTML5, which makes CSS selectors case-sensitive. Interfaces built with Moonstone are not affected. 

The migration guide explains how to adapt a UI extension to each of these changes.

Improvements

  • Opened the migration window for UI extensions built with Vite: app-shell 4 loads UI extensions built with webpack and with Vite. Webpack support will end with app-shell 5. 
  • Added formik to the libraries that the app-shell provides to UI extensions. 
  • Added the React entry points react/jsx-runtime, react/jsx-dev-runtime and react-dom/client to the libraries that the app-shell provides. 

Bug fixes

  • Fixed GWT dialogs (publication workflow, compare versions, workflows, live roles…) that showed an empty grey block instead of their content. 

Misc

  • Changed the minimum Jahia version to 8.2.2.0. Upgrade Jahia to 8.2.2.0 or later before you install this version.
  • Added maven.jahia.com to the Maven repositories that app-shell uses to download its dependencies.
Nécessite Jahia 8.2.2.0Publié le 2026-11-03

Breaking Changes

  • Removed the legacy window.jahiaCommons loader and the alpha version of Moonstone from the libraries that Jahia shares with UI extensions. 
    • Am I impacted? Only if one of your UI extensions calls window.jahiaCommons, reads window.jahia.modules, or imports @jahia/moonstone-alpha without bundling it. Such an extension fails to load in jContent and the other Jahia UIs.
    • What to do: rebuild the extension with module federation and @jahia/moonstone, or bundle the library it needs.

Misc

  • Changed the minimum Jahia version to 8.1.8.0. Upgrade Jahia to 8.1.8.0 or later before you install this version. 
  • Updated all JS dependencies of the federation host within their accepted SemVer range. 
Nécessite Jahia 8.1.8.0Publié le 2026-10-23

Bug fixes

  • Fixed an error resulting in error logs in the browser's developer tools when navigating between pages
  • Fixed a character encoding issue in the profile name in the main menu
Nécessite Jahia 8.1.6.0Publié le 2025-01-30

Bug fixes

  • Fixed a loading issue when using Firefox 130 on Windows
Nécessite Jahia 8.1.3.0Publié le 2026-08-12

Improvements

  • Improved Jahia loading screen by adding information messages and a better handling of errors
  • Updated the webpack configuration to use the shared one
  • Upgraded React from 16.12.0 to 18.2.0

Bug fixes

  • Fixed random blank page in administration pages due to the module not initializing correctly
  • Fixed blank page issue when accessing administration pages due to wrong site and language resolution
Nécessite Jahia 8.0.0.0Publié le 2024-09-26

Breaking Change

  • Fixed issue with custom login/error pages handling (more details here)

Bugfixes

  • Fixed issue with labels (cache to be flushed) when upgrading the module
Nécessite Jahia 8.0.0.0Publié le 2024-07-29

Bug fixes

  • Fixed a loading issue when using Firefox 130 on Windows
  • Removed usage of introspection query SCHEMA_FIELDS_QUERY
Nécessite Jahia 8.1.3.0Publié le 2024-09-26
  • Fixed blank page issue when accessing adminstration pages due to wrong site and language resolution
  • Fixed random blank page in administration pages due to the module not initializing correctly
Nécessite Jahia 8.0.0.0Publié le 2023-11-14
  • Fixed issue with labels (cache to be flushed) when upgrading the module
Nécessite Jahia 8.0.0.0Publié le 2023-04-12
  • Fixed issue with site users not able to log in
Nécessite Jahia 8.0.0.0Publié le 2022-11-15
  • Upgraded to Apollo3
  • Improved performances when flushing the cache key
Nécessite Jahia 8.0.0.0Publié le 2022-06-21
  • Improved handling of non existing JS files while loading modules, to prevent 404 or white screens
  • Added logs to inform when some files could not be loaded because of a slow network
Nécessite Jahia 8.0.0.0Publié le 2022-06-16
  • Updated the configuration to use websocket connection for subscriptions (See GraphQL v2.7.0)
  • Updated vulnerable dependencies
Nécessite Jahia 8.0.0.0Publié le 2021-11-04
  • Apolloclient library is now available in window.jahia Javascript object
Nécessite Jahia 8.0.0.0Publié le 2021-06-17

The version of the AppShell packaged with Jahia 8.0.2.0 introduced a breaking change impacting customers who developed custom extensions for jContent and Content Editor with Jahia 8.0.1.

This new version of AppShell (2.2.1) restores functionality for impacted customers when migrating from Jahia 8.0.1.0 to Jahia 8.0.2.0.

Customers starting their project with Jahia 8.0.2.0 are not impacted.

 

Nécessite Jahia 8.0.0.0Publié le 2021-03-05