Skip to main content
Jahia Store
EN

Jahia App-shell

supported
Download 4.0.0

Information

Module ID
app-shell
Group ID
org.jahia.modules
Status
supported
Category
Platform
Author
JSG
Developer website
http://www.jahia.com
Requires Jahia
8.2.2.0
Released
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.
Requires Jahia 8.2.2.0Released 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. 
Requires Jahia 8.1.8.0Released 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
Requires Jahia 8.1.6.0Released 2025-01-30

Bug fixes

  • Fixed a loading issue when using Firefox 130 on Windows
Requires Jahia 8.1.3.0Released 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
Requires Jahia 8.0.0.0Released 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
Requires Jahia 8.0.0.0Released 2024-07-29
2.10.0Download

Bug fixes

  • Fixed a loading issue when using Firefox 130 on Windows
  • Removed usage of introspection query SCHEMA_FIELDS_QUERY
Requires Jahia 8.1.3.0Released 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
Requires Jahia 8.0.0.0Released 2023-11-14
  • Fixed issue with labels (cache to be flushed) when upgrading the module
Requires Jahia 8.0.0.0Released 2023-04-12
  • Fixed issue with site users not able to log in
Requires Jahia 8.0.0.0Released 2022-11-15
  • Upgraded to Apollo3
  • Improved performances when flushing the cache key
Requires Jahia 8.0.0.0Released 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
Requires Jahia 8.0.0.0Released 2022-06-16
  • Updated the configuration to use websocket connection for subscriptions (See GraphQL v2.7.0)
  • Updated vulnerable dependencies
Requires Jahia 8.0.0.0Released 2021-11-04
  • Apolloclient library is now available in window.jahia Javascript object
Requires Jahia 8.0.0.0Released 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.

 

Requires Jahia 8.0.0.0Released 2021-03-05