Cristal 0.13+

We are aware the error below can be raised at startup with some Ubuntu 24.04+. If you encounter this error, please use the flatpak packaging.

[96548:0131/111121.194880:FATAL:setuid_sandbox_host.cc(163)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /tmp/.mount_cristarlmbQ8/chrome-sandbox is owned by root and has mode 4755.
[1]    96548 trace trap (core dumped)  ./cristal-0.13.0-linux-x86_64.AppImage

Cristal 0.23+

If you need to customize the vue-router component used by the Cristal instance you want to embed, the @xwiki/cristal-lib package exports a RouterFactory interface:

/**
 * A factory to initialize an instance of Vue router.
 * By default, no implementation is provided. If there is one available,
 * it will be used instead of the default initialization. Use the
 * "RouterFactory" role to bind your custom implementation.
 * @since 0.23
 */
interface RouterFactory {
  initializeRouter(routes: RouteRecordRaw[]): Router;
}

You can create and bind your own implementation to the inversify role RouterFactory, and it will be used automatically instead of the default router initialization.