@finos/legend-application 14.0.4 → 15.0.0

package/src/application/LegendApplicationConfig.ts

@@ -30,6 +30,7 @@ import {
   type ContextualDocumentationEntry,
   type DocumentationRegistryEntry,
 } from '../stores/DocumentationService.js';
+import type { SettingOverrideConfigData } from '../stores/SettingService.js';
 
 export interface LegendApplicationVersionData {
   buildTime: string;
@@ -46,6 +47,10 @@ export interface LegendApplicationConfigurationData {
     entries?: Record<string, DocumentationEntryData>;
     contextualEntries?: ContextualDocumentationConfig;
   };
+  application?: {
+    storageKey?: string;
+    settingsOverrides?: SettingOverrideConfigData;
+  };
   // TODO: when we support vault-like settings, we could support `settingOverrides`
   // See https://github.com/finos/legend-studio/issues/407
   // settingOverrides
@@ -54,8 +59,9 @@ export interface LegendApplicationConfigurationData {
 
 export abstract class LegendApplicationConfig {
   readonly appName: string;
-  readonly baseUrl: string;
+  readonly baseAddress: string;
   readonly env: string;
+  readonly applicationStorageKey: string;
 
   // documentation
   readonly documentationUrl?: string | undefined;
@@ -71,7 +77,7 @@ export abstract class LegendApplicationConfig {
   constructor(
     input: LegendApplicationConfigurationInput<LegendApplicationConfigurationData>,
   ) {
-    this.baseUrl = input.baseUrl;
+    this.baseAddress = input.baseAddress;
     this.appName = guaranteeNonEmptyString(
       input.configData.appName,
       `Can't configure application: 'appName' field is missing or empty`,
@@ -80,6 +86,9 @@ export abstract class LegendApplicationConfig {
       input.configData.env,
       `Can't configure application: 'env' field is missing or empty`,
     );
+    this.applicationStorageKey =
+      input.configData.application?.storageKey ??
+      this.getDefaultApplicationStorageKey();
 
     // Documentation
     this.documentationUrl = input.configData.documentation?.url;
@@ -113,4 +122,6 @@ export abstract class LegendApplicationConfig {
     }
     return url;
   }
+
+  abstract getDefaultApplicationStorageKey(): string;
 }

package/src/browser.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export * from './components/BrowserEnvironmentProvider.js';
+export * from './stores/platform/BrowserPlatform.js';
+export * from './stores/navigation/BrowserNavigator.js';

package/src/components/{LegendApplicationComponentFrameworkProvider.tsx → ApplicationComponentFrameworkProvider.tsx}

@@ -28,7 +28,7 @@ import {
   type KeyBindingConfig,
 } from '@finos/legend-shared';
 import { VirtualAssistant } from './VirtualAssistant.js';
-import { LegendApplicationTelemetryHelper } from '../application/LegendApplicationTelemetry.js';
+import { LegendApplicationTelemetryHelper } from '../__lib__/LegendApplicationTelemetry.js';
 import type { GenericLegendApplicationStore } from '../stores/ApplicationStore.js';
 
 enum APPLICATION_COMPONENT_ELEMENT_ID {
@@ -114,7 +114,7 @@ export const BackdropContainer: React.FC<{ elementId: string }> = (props) => (
   <div className="backdrop__container" data-elementid={props.elementId} />
 );
 
-export const LegendApplicationComponentFrameworkProvider = observer(
+export const ApplicationComponentFrameworkProvider = observer(
   (props: { children: React.ReactNode }) => {
     const { children } = props;
     const applicationStore = useApplicationStore();

package/src/components/ApplicationFrameworkProvider.tsx

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useEffect } from 'react';
+import { observer } from 'mobx-react-lite';
+import { ApplicationComponentFrameworkProvider } from './ApplicationComponentFrameworkProvider.js';
+import { useApplicationStore } from './ApplicationStoreProvider.js';
+import { useApplicationPlatform } from './ApplicationPlatformProvider.js';
+
+export const ApplicationFrameworkProvider = observer(
+  (props: { children: React.ReactNode }): React.ReactElement => {
+    const { children } = props;
+    const platform = useApplicationPlatform();
+    const applicationStore = useApplicationStore();
+
+    useEffect(() => {
+      applicationStore
+        .initialize(platform)
+        .catch(applicationStore.alertUnhandledError);
+    }, [applicationStore, platform]);
+
+    if (!applicationStore.initState.hasSucceeded) {
+      return <></>;
+    }
+    // TODO: would be great if we can have <React.StrictMode> here but since Mobx React is not ready for
+    // concurrency yet, we would have to wait
+    // See https://github.com/mobxjs/mobx/issues/2526
+    return (
+      <ApplicationComponentFrameworkProvider>
+        {children}
+      </ApplicationComponentFrameworkProvider>
+    );
+  },
+);

package/src/components/ApplicationPlatformProvider.tsx

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { guaranteeNonNullable } from '@finos/legend-shared';
+import { createContext, useContext } from 'react';
+import type { ApplicationPlatform } from '../stores/platform/ApplicationPlatform.js';
+
+export const ApplicationPlatformContext = createContext<
+  ApplicationPlatform | undefined
+>(undefined);
+
+export const useApplicationPlatform = (): ApplicationPlatform =>
+  guaranteeNonNullable(
+    useContext(ApplicationPlatformContext),
+    `Can't find application platform in context`,
+  );

package/src/components/ApplicationStoreProvider.tsx

@@ -14,15 +14,14 @@
  * limitations under the License.
  */
 
-import { createContext, useContext, useEffect } from 'react';
-import { observer, useLocalObservable } from 'mobx-react-lite';
-import {
+import { createContext, useContext } from 'react';
+import { useLocalObservable } from 'mobx-react-lite';
+import type {
   ApplicationStore,
-  type GenericLegendApplicationStore,
+  GenericLegendApplicationStore,
 } from '../stores/ApplicationStore.js';
 import type { LegendApplicationConfig } from '../application/LegendApplicationConfig.js';
 import { guaranteeNonNullable } from '@finos/legend-shared';
-import { useWebApplicationNavigator } from './WebApplicationNavigatorProvider.js';
 import type { LegendApplicationPluginManager } from '../application/LegendApplicationPluginManager.js';
 import type { LegendApplicationPlugin } from '../stores/LegendApplicationPlugin.js';
 
@@ -39,44 +38,20 @@ export const useApplicationStore = <
     `Can't find application store in context`,
   );
 
-const ApplicationContent = observer(
-  (props: { children: React.ReactNode }): React.ReactElement => {
-    const { children } = props;
-    const applicationStore = useApplicationStore();
-
-    useEffect(() => {
-      applicationStore.initialize().catch(applicationStore.alertUnhandledError);
-    }, [applicationStore]);
-
-    if (!applicationStore.initState.hasSucceeded) {
-      return <></>;
-    }
-    // TODO: would be great if we can have <React.StrictMode> here but since Mobx React is not ready for
-    // concurrency yet, we would have to wait
-    // See https://github.com/mobxjs/mobx/issues/2526
-    return <>{children}</>;
-  },
-);
-
 export const ApplicationStoreProvider = <
   T extends LegendApplicationConfig,
   V extends LegendApplicationPluginManager<LegendApplicationPlugin>,
 >({
   children,
-  config,
-  pluginManager,
+  store,
 }: {
   children: React.ReactNode;
-  config: T;
-  pluginManager: V;
+  store: ApplicationStore<T, V>;
 }): React.ReactElement => {
-  const navigator = useWebApplicationNavigator();
-  const applicationStore = useLocalObservable(
-    () => new ApplicationStore(config, navigator, pluginManager),
-  );
+  const applicationStore = useLocalObservable(() => store);
   return (
     <ApplicationStoreContext.Provider value={applicationStore}>
-      <ApplicationContent>{children}</ApplicationContent>
+      {children}
     </ApplicationStoreContext.Provider>
   );
 };

package/src/components/BrowserEnvironmentProvider.tsx

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { type History } from 'history';
+import { useLocalObservable } from 'mobx-react-lite';
+import { useHistory } from 'react-router';
+import { BrowserRouter } from 'react-router-dom';
+import { BrowserPlatform } from '../stores/platform/BrowserPlatform.js';
+import { ApplicationPlatformContext } from './ApplicationPlatformProvider.js';
+import { useApplicationStore } from './ApplicationStoreProvider.js';
+
+const BrowserPlatformProvider: React.FC<{
+  children: React.ReactNode;
+}> = ({ children }) => {
+  const applicationStore = useApplicationStore();
+  const historyAPI = useHistory() as History; // TODO: this is a temporary hack until we upgrade react-router
+  const platform = useLocalObservable(
+    () => new BrowserPlatform(applicationStore, { historyAPI }),
+  );
+
+  return (
+    <ApplicationPlatformContext.Provider value={platform}>
+      {children}
+    </ApplicationPlatformContext.Provider>
+  );
+};
+
+export const BrowserEnvironmentProvider: React.FC<{
+  children: React.ReactNode;
+  baseUrl: string;
+}> = ({ children, baseUrl }) => (
+  <BrowserRouter basename={baseUrl}>
+    <BrowserPlatformProvider>{children}</BrowserPlatformProvider>
+  </BrowserRouter>
+);

package/src/components/VirtualAssistant.tsx

@@ -38,8 +38,11 @@ import {
   FaceSadTearIcon,
   CogIcon,
   Draggable,
+  BaseRadioGroup,
+  QuestionCircleIcon,
 } from '@finos/legend-art';
 import {
+  ADVANCED_FUZZY_SEARCH_MODE,
   ContentType,
   debounce,
   downloadFileUsingDataURI,
@@ -49,15 +52,17 @@ import {
 } from '@finos/legend-shared';
 import { observer } from 'mobx-react-lite';
 import { useEffect, useMemo, useRef, useState } from 'react';
-import { TAB_SIZE } from '../const.js';
+import {
+  DEFAULT_DATE_TIME_FORMAT,
+  DEFAULT_TAB_SIZE,
+} from '../stores/ApplicationConfig.js';
 import {
   type VirtualAssistantDocumentationEntry,
   VIRTUAL_ASSISTANT_TAB,
 } from '../stores/AssistantService.js';
 import { useApplicationStore } from './ApplicationStoreProvider.js';
-import { DATE_TIME_FORMAT } from '@finos/legend-graph';
-import { LegendApplicationTelemetryHelper } from '../application/LegendApplicationTelemetry.js';
-import { FuzzySearchAdvancedConfigMenu } from './shared/FuzzySearchAdvancedConfigMenu.js';
+import { LegendApplicationTelemetryHelper } from '../__lib__/LegendApplicationTelemetry.js';
+import { LEGEND_APPLICATION_DOCUMENTATION_KEY } from '../__lib__/LegendApplicationDocumentation.js';
 
 const WIZARD_GREETING = `Bonjour, It's Pierre!`;
 
@@ -293,12 +298,12 @@ const VirtualAssistantSearchPanel = observer(() => {
     downloadFileUsingDataURI(
       `documentation-registry_${formatDate(
         new Date(Date.now()),
-        DATE_TIME_FORMAT,
+        DEFAULT_DATE_TIME_FORMAT,
       )}.json`,
       JSON.stringify(
         applicationStore.documentationService.publishDocRegistry(),
         undefined,
-        TAB_SIZE,
+        DEFAULT_TAB_SIZE,
       ),
       ContentType.APPLICATION_JSON,
     );
@@ -307,12 +312,12 @@ const VirtualAssistantSearchPanel = observer(() => {
     downloadFileUsingDataURI(
       `documentation-registry_${formatDate(
         new Date(Date.now()),
-        DATE_TIME_FORMAT,
+        DEFAULT_DATE_TIME_FORMAT,
       )}.json`,
       JSON.stringify(
         applicationStore.documentationService.publishContextualDocIndex(),
         undefined,
-        TAB_SIZE,
+        DEFAULT_TAB_SIZE,
       ),
       ContentType.APPLICATION_JSON,
     );
@@ -414,9 +419,46 @@ const VirtualAssistantSearchPanel = observer(() => {
               assistantService.showSearchConfigurationMenu,
           })}
         >
-          <FuzzySearchAdvancedConfigMenu
-            configState={assistantService.searchConfigurationState}
-          />
+          <div className="virtual-assistant__search__input__advanced-config__panel">
+            <div className="virtual-assistant__search__input__advanced-config__panel__header__label">
+              search config
+              {applicationStore.documentationService.hasDocEntry(
+                LEGEND_APPLICATION_DOCUMENTATION_KEY.QUESTION_HOW_TO_USE_ADVANCED_SEARCH_SYNTAX,
+              ) && (
+                <div
+                  onClick={() =>
+                    assistantService.openDocumentationEntryLink(
+                      LEGEND_APPLICATION_DOCUMENTATION_KEY.QUESTION_HOW_TO_USE_ADVANCED_SEARCH_SYNTAX,
+                    )
+                  }
+                  title="Click to see documentation"
+                  className="virtual-assistant__search__input__advanced-config__panel__header__label__hint"
+                >
+                  <QuestionCircleIcon />
+                </div>
+              )}
+            </div>
+            <div>
+              <BaseRadioGroup
+                value={assistantService.searchConfigurationState.currentMode}
+                onChange={(event): void => {
+                  const searchMode = event.target
+                    .value as ADVANCED_FUZZY_SEARCH_MODE;
+                  assistantService.searchConfigurationState.setCurrentMode(
+                    searchMode,
+                  );
+                }}
+                row={false}
+                options={[
+                  ADVANCED_FUZZY_SEARCH_MODE.STANDARD,
+                  ADVANCED_FUZZY_SEARCH_MODE.INCLUDE,
+                  ADVANCED_FUZZY_SEARCH_MODE.EXACT,
+                  ADVANCED_FUZZY_SEARCH_MODE.INVERSE,
+                ]}
+                size={1}
+              />
+            </div>
+          </div>
         </div>
         {assistantService.currentDocumentationEntry && (
           <div className="virtual-assistant__search__results">

package/src/components/__test-utils__/BrowserEnvironmentTestUtils.tsx

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { createMemoryHistory, type History } from 'history';
+import { useLocalObservable } from 'mobx-react-lite';
+import { Router } from 'react-router';
+import { BrowserPlatform } from '../../stores/platform/BrowserPlatform.js';
+import { ApplicationPlatformContext } from '../ApplicationPlatformProvider.js';
+import { type GenericLegendApplicationStore } from '../../stores/ApplicationStore.js';
+import { useApplicationStore } from '../ApplicationStoreProvider.js';
+import { createMock } from '@finos/legend-shared/test';
+
+export { createMemoryHistory };
+
+export const TEST__BrowserEnvironmentProvider: React.FC<{
+  children: React.ReactNode;
+  historyAPI?: History | undefined;
+}> = ({ children, historyAPI }) => {
+  const applicationStore = useApplicationStore();
+  const history = historyAPI ?? createMemoryHistory();
+  const platform = useLocalObservable(
+    () => new BrowserPlatform(applicationStore, { historyAPI: history }),
+  );
+
+  return (
+    <Router history={history}>
+      <ApplicationPlatformContext.Provider value={platform}>
+        {children}
+      </ApplicationPlatformContext.Provider>
+    </Router>
+  );
+};
+
+export const TEST__provideMockedBrowserPlatform = (
+  applicationStore: GenericLegendApplicationStore,
+  customization?: {
+    mock?: BrowserPlatform;
+    historyAPI?: History;
+  },
+): BrowserPlatform => {
+  const value =
+    customization?.mock ??
+    new BrowserPlatform(applicationStore, {
+      historyAPI: customization?.historyAPI ?? createMemoryHistory(),
+    });
+  const MOCK__BrowserPlatform = require('../ApplicationPlatformProvider.js'); // eslint-disable-line @typescript-eslint/no-unsafe-assignment
+  MOCK__BrowserPlatform.useApplicationPlatform = createMock();
+  MOCK__BrowserPlatform.useApplicationPlatform.mockReturnValue(value);
+  return value;
+};

package/src/index.ts

@@ -14,26 +14,28 @@
  * limitations under the License.
  */
 
-export * from './const.js';
+export * from './stores/ApplicationConfig.js';
 
 export * from './application/LegendApplication.js';
 export * from './application/LegendApplicationConfig.js';
 export * from './application/LegendApplicationPluginManager.js';
-export * from './application/LegendApplicationEvent.js';
-export * from './application/LegendApplicationTelemetry.js';
-export * from './application/LegendApplicationSetting.js';
-export { LEGEND_APPLICATION_COLOR_THEME } from './application/LegendApplicationTheme.js';
+
+export * from './__lib__/LegendApplicationEvent.js';
+export * from './__lib__/LegendApplicationTelemetry.js';
+export * from './__lib__/LegendApplicationSetting.js';
+export * from './__lib__/LegendApplicationDocumentation.js';
+export { LEGEND_APPLICATION_COLOR_THEME } from './__lib__/LegendApplicationTheme.js';
 
 export * from './components/ApplicationStoreProvider.js';
-export * from './components/WebApplicationNavigatorProvider.js';
-export * from './components/LegendApplicationComponentFrameworkProvider.js';
+export * from './components/ApplicationFrameworkProvider.js';
 export * from './components/useApplicationNavigationContext.js';
 export * from './components/useCommands.js';
-export * from './components/ApplicationStoreProviderTestUtils.js';
-export * from './components/WebApplicationNavigatorProviderTestUtils.js';
+export {
+  forceDispatchKeyboardEvent,
+  BackdropContainer,
+} from './components/ApplicationComponentFrameworkProvider.js';
 
 export * from './stores/ApplicationStore.js';
-export { WebApplicationNavigator } from './stores/navigation/WebApplicationNavigator.js';
 export {
   NavigationService,
   type NavigationAddress,
@@ -54,18 +56,4 @@ export * from './stores/AssistantService.js';
 export * from './stores/ApplicationNavigationContextService.js';
 export * from './stores/LegendApplicationPlugin.js';
 export * from './stores/Core_LegendApplicationPlugin.js';
-
-export * from './stores/ApplicationStoreTestUtils.js';
-export * from './stores/navigation/WebApplicationRouter.js';
 export { DISPLAY_ANSI_ESCAPE } from './stores/terminal/Terminal.js';
-
-// ------------------------------------------- TO BE MOVED -------------------------------------------
-
-// TODO: move to `@finos/legend-lego/code-editor`
-export {
-  PURE_GRAMMAR_TOKEN,
-  setupPureLanguageService,
-} from './stores/pure-language/PureLanguageSupport.js';
-export * from './stores/pure-language/PureLanguageCodeEditorSupport.js';
-export * from './components/shared/PackageableElementOptionLabel.js';
-export * from './stores/shared/PackageableElementOption.js';

package/src/stores/ApplicationConfig.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export const DEFAULT_TAB_SIZE = 2;
+export const DEFAULT_MONOSPACED_FONT_FAMILY = 'Roboto Mono';
+export const DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd'T'HH:mm:ss";
+
+export const DEFAULT_TYPEAHEAD_SEARCH_MINIMUM_SEARCH_LENGTH = 2;
+export const DEFAULT_TYPEAHEAD_SEARCH_LIMIT = 10;

package/src/stores/ApplicationNavigationContextService.ts

@@ -17,7 +17,7 @@
 import { IllegalStateError } from '@finos/legend-shared';
 import { action, computed, makeObservable, observable } from 'mobx';
 import type { GenericLegendApplicationStore } from './ApplicationStore.js';
-import { LegendApplicationTelemetryHelper } from '../application/LegendApplicationTelemetry.js';
+import { LegendApplicationTelemetryHelper } from '../__lib__/LegendApplicationTelemetry.js';
 
 /**
  * Context data refers to the area of the application that the user is

package/src/stores/ApplicationStore.ts

@@ -21,10 +21,11 @@ import {
   uuid,
   ActionState,
   assertErrorThrown,
+  IllegalStateError,
+  type Writable,
 } from '@finos/legend-shared';
-import { APPLICATION_EVENT } from '../application/LegendApplicationEvent.js';
+import { APPLICATION_EVENT } from '../__lib__/LegendApplicationEvent.js';
 import type { LegendApplicationConfig } from '../application/LegendApplicationConfig.js';
-import type { WebApplicationNavigator } from './navigation/WebApplicationNavigator.js';
 import type { LegendApplicationPluginManager } from '../application/LegendApplicationPluginManager.js';
 import { DocumentationService } from './DocumentationService.js';
 import { AssistantService } from './AssistantService.js';
@@ -44,6 +45,8 @@ import { LayoutService } from './LayoutService.js';
 import { ClipboardService } from './ClipboardService.js';
 import { NavigationService } from './navigation/NavigationService.js';
 import { SettingService } from './SettingService.js';
+import { DefaultNavigator } from './navigation/DefaultNavigator.js';
+import type { ApplicationPlatform } from './platform/ApplicationPlatform.js';
 
 export type GenericLegendApplicationStore = ApplicationStore<
   LegendApplicationConfig,
@@ -59,6 +62,7 @@ export class ApplicationStore<
   readonly config: T;
   readonly pluginManager: V;
   readonly initState = ActionState.create();
+  readonly platform?: ApplicationPlatform | undefined;
 
   // core
   readonly timeService: TimeService;
@@ -86,15 +90,7 @@ export class ApplicationStore<
   readonly telemetryService: TelemetryService;
   readonly tracerService: TracerService;
 
-  constructor(
-    config: T,
-    /**
-     * NOTE: as of now, we only support web environment, we will not provide a generic `ApplicationNavigator`
-     * This is something we need to think about when we potentially move to another platform
-     */
-    navigator: WebApplicationNavigator,
-    pluginManager: V,
-  ) {
+  constructor(config: T, pluginManager: V) {
     this.config = config;
     this.pluginManager = pluginManager;
 
@@ -114,7 +110,7 @@ export class ApplicationStore<
     this.commandService = new CommandService(this);
     this.keyboardShortcutsService = new KeyboardShortcutsService(this);
 
-    this.navigationService = new NavigationService(navigator);
+    this.navigationService = new NavigationService(new DefaultNavigator());
     this.navigationContextService = new ApplicationNavigationContextService(
       this,
     );
@@ -135,7 +131,7 @@ export class ApplicationStore<
     this.tracerService.registerPlugins(pluginManager.getTracerServicePlugins());
   }
 
-  async initialize(): Promise<void> {
+  async initialize(platform: ApplicationPlatform): Promise<void> {
     if (!this.initState.isInInitialState) {
       this.notificationService.notifyIllegalState(
         'Application store is re-initialized',
@@ -145,12 +141,15 @@ export class ApplicationStore<
     this.initState.inProgress();
 
     try {
-      await Promise.all(
-        this.pluginManager
-          .getApplicationPlugins()
-          .flatMap((plugin) => plugin.getExtraApplicationSetups?.() ?? [])
-          .map((setup) => setup(this)),
-      );
+      if (this.platform) {
+        throw new IllegalStateError(`Platform is already configured`);
+      }
+      (this as Writable<ApplicationStore<T, V>>).platform = platform;
+      (this as Writable<ApplicationStore<T, V>>).navigationService =
+        new NavigationService(platform.getNavigator());
+
+      await platform.initialize();
+
       this.initState.pass();
     } catch (error) {
       assertErrorThrown(error);