Function: createApp()

function createApp<T>(config: {
  cache?: CacheConfig;
  client?: WorkspaceClient;
  disableInternalTelemetry?: boolean;
  onPluginsReady?: (appkit: PluginMap<T>) => void | Promise<void>;
  plugins?: T;
  telemetry?: TelemetryConfig;
}): Promise<PluginMap<T>>;

Bootstraps AppKit with the provided configuration.

Initializes telemetry, cache, and service context, then registers plugins in phase order (core, normal, deferred) and awaits their setup. If a onPluginsReady callback is provided it runs after plugin setup but before the server starts, giving you access to the full appkit handle for registering custom routes or performing async setup. The returned object maps each plugin name to its exports() API, with an asUser(req) method for user-scoped execution.

Type Parameters

Parameters

Returns

Promise<PluginMap<T>>

A PluginMap keyed by plugin name with typed exports

Examples

import { createApp, server } from "@databricks/appkit";

await createApp({
  plugins: [server()],
});

import { createApp, server, analytics } from "@databricks/appkit";

await createApp({
  plugins: [server(), analytics({})],
  onPluginsReady(appkit) {
    appkit.server.extend((app) => {
      app.get("/custom", (_req, res) => res.json({ ok: true }));
    });
  },
});