@lukoweb/apitogo 0.2.31 → 0.2.34

package/dist/declarations/app/entry.server.d.ts

@@ -1,7 +1,7 @@
 import { type RouteObject } from "react-router";
 import "vite/modulepreload-polyfill";
-import { getRoutesByConfig } from "./main.js";
-export { getRoutesByConfig };
+import type { ApitogoConfig } from "../config/config.js";
+export declare const getRoutesByConfig: (config: ApitogoConfig) => RouteObject[];
 export declare const handleRequest: ({ template, request, routes, basePath, bypassProtection, }: {
     template: string;
     request: Request;

package/dist/declarations/app/main.d.ts

@@ -2,6 +2,7 @@ import type { RouteObject } from "react-router";
 import type { HighlighterCore } from "shiki";
 import "virtual:zudoku-theme.css";
 import type { ApitogoConfig } from "../config/config.js";
+import type { ResolvedModulesConfig } from "../config/validators/ModulesSchema.js";
 import "./main.css";
 import "./polyfills.js";
 import type { ZudokuContextOptions } from "../lib/core/ZudokuContext.js";
@@ -99,4 +100,5 @@ export declare const getRoutesByOptions: (options: ZudokuContextOptions, enableS
         ErrorBoundary?: (() => Promise<import("react").ComponentType<{}> | null | undefined>) | undefined;
     }) | import("react-router").LazyRouteFunction<RouteObject>;
 })[];
-export declare const getRoutesByConfig: (config: ApitogoConfig) => RouteObject[];
+export type ModulesResolver = (config: ApitogoConfig) => ResolvedModulesConfig;
+export declare const getRoutesByConfig: (config: ApitogoConfig, resolveModules: ModulesResolver) => RouteObject[];

package/dist/declarations/cli/platform/client/platform-api.d.ts

@@ -206,9 +206,6 @@ export interface CheckoutSessionResponse {
     url: string | null;
     granted?: boolean;
 }
-export interface DeploymentTokenResponse {
-    token: string;
-}
 export interface ProvisioningJobListItemDto {
     id: string;
     resourceType: string;
@@ -538,7 +535,6 @@ export declare class PlatformApiClient {
     retryAzureInfrastructure(projectId: string): Promise<StartDeployResponse>;
     getAzureInfrastructureDeployStatus(projectId: string, jobId: string): Promise<DeployStatusResponse>;
     listProvisioningJobs(projectId: string): Promise<ProvisioningJobListResponse>;
-    getDeploymentToken(projectId: string, regenerate?: boolean): Promise<DeploymentTokenResponse>;
     uploadStaticWebDeployment(projectId: string, archivePath: string, env?: string): Promise<StaticWebSiteDeploymentDto>;
     listSecrets(projectId: string): Promise<ProjectSecretListResponse>;
     setSecret(projectId: string, name: string, value: string): Promise<SetProjectSecretResponse>;

package/dist/declarations/cli/platform/helpers/deploy-artifact-hash.d.ts

@@ -1,6 +1,6 @@
 export declare function sha256File(filePath: string): Promise<string>;
 export declare function sha256Buffer(data: Buffer | string): Promise<string>;
-export declare function hashDirectoryContents(rootDirectory: string): Promise<string>;
+export declare function hashDirectoryContents(rootDirectory: string, extraExcludes?: readonly string[]): Promise<string>;
 export declare function hashDevPortalSiteSources(siteDirectory: string, options?: {
     gatewayUrl?: string | null;
 }): Promise<string>;

package/dist/declarations/cli/platform/helpers/package-files.d.ts

@@ -1 +1 @@
-export declare function collectPackageableFiles(sourceDirectory: string): Promise<string[]>;
+export declare function collectPackageableFiles(sourceDirectory: string, extraExcludes?: readonly string[]): Promise<string[]>;

package/dist/declarations/cli/platform/helpers/zip.d.ts

@@ -2,5 +2,5 @@ export interface PackageBackendResult {
     zipPath: string;
     byteSize: number;
 }
-export declare function packageBackendDirectory(sourceDirectory: string): Promise<PackageBackendResult>;
+export declare function packageBackendDirectory(sourceDirectory: string, extraExcludes?: readonly string[]): Promise<PackageBackendResult>;
 export declare function cleanupZip(zipPath: string): Promise<void>;

package/dist/declarations/cli/platform/tools/infrastructure.d.ts

@@ -21,10 +21,6 @@ export declare function handleRetryAzureInfrastructure(client: PlatformApiClient
 export declare function handleListProvisioningJobs(client: PlatformApiClient, config: ApitogoConfig, args: {
     projectId?: string;
 }): Promise<string>;
-export declare function handleGetDeploymentToken(client: PlatformApiClient, config: ApitogoConfig, args: {
-    projectId?: string;
-    regenerate?: boolean;
-}): Promise<string>;
 export declare function handleGetCustomDomain(client: PlatformApiClient, config: ApitogoConfig, args: {
     projectId?: string;
 }): Promise<string>;

package/dist/declarations/config/effective-redirects.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedModulesConfig } from "./validators/ModulesSchema.js";
+import type { ZudokuConfig } from "./validators/ZudokuConfig.js";
+export declare const getEffectiveRedirects: (config: ZudokuConfig, resolved: ResolvedModulesConfig) => {
+    from: string;
+    to: string;
+}[];

package/dist/declarations/config/header-navigation-guard.d.ts

@@ -0,0 +1,2 @@
+import type { HeaderNavGroup, HeaderNavItem, HeaderNavLinkItem } from "./validators/HeaderNavigationSchema.js";
+export declare const isHeaderNavGroup: (item: HeaderNavItem | HeaderNavLinkItem | HeaderNavGroup) => item is HeaderNavGroup;

package/dist/declarations/config/resolve-modules.d.ts

@@ -8,10 +8,7 @@ export declare const resolveDashboardContent: (content?: DashboardContentConfig)
 export declare const resolveProfileContent: (content?: ProfileContentConfig) => ResolvedProfileContent;
 export declare const resolvePlansContent: (content?: PlansContentConfig) => ResolvedPlansContent;
 export declare const resolveModulesConfig: (config: ZudokuConfig) => ResolvedModulesConfig;
-export declare const getEffectiveRedirects: (config: ZudokuConfig, resolved: ResolvedModulesConfig) => {
-    from: string;
-    to: string;
-}[];
+export { getEffectiveRedirects } from "./effective-redirects.js";
 export declare const getEffectiveDocsConfig: (_config: ZudokuConfig, resolved: ResolvedModulesConfig) => {
     files: string | string[];
     publishMarkdown: boolean;

package/dist/declarations/config/validators/HeaderNavigationSchema.d.ts

@@ -15800,9 +15800,8 @@ export declare const HeaderNavigationSchema: z.ZodArray<z.ZodUnion<readonly [z.Z
         }, z.core.$strip>>;
     }, z.core.$strip>]>>;
 }, z.core.$strip>]>>;
-export declare const isHeaderNavGroup: (item: HeaderNavItem | HeaderNavLinkItem | HeaderNavGroup) => item is HeaderNavGroup;
+export { isHeaderNavGroup } from "../header-navigation-guard.js";
 export type HeaderNavLinkItem = z.infer<typeof HeaderNavLinkItemSchema>;
 export type HeaderNavGroup = z.infer<typeof HeaderNavGroupSchema>;
 export type HeaderNavItem = z.infer<typeof HeaderNavItemSchema>;
 export type HeaderNavigation = z.infer<typeof HeaderNavigationSchema>;
-export {};

package/docs/cli/commands.md

@@ -58,6 +58,25 @@ See [Make config (CLI)](../configuration/make-config.mdx) for all `config` flags
 
 Env: `APITOGO_API_KEY_ID`, `APITOGO_API_SECRET`. Optional: `APITOGO_API_URL`.
 
+## Config version 2: add a service
+
+```bash
+npx apitogo add gateway
+```
+
+`add` puts one service (`portal`, `gateway`, `identity` or `plans`) into `apitogo.config.json`. In a
+terminal it **asks** for what you did not pass as a flag: for the gateway how it reaches your API
+(an address you host, or code the platform runs, with the folder, runtime and version) and which
+OpenAPI file to use. For an OIDC identity it asks for the issuer, and for external docs the address
+of the docs site. It shows the change and asks before it writes.
+
+Some services need another one. `plans` needs the gateway and an identity source, and a portal that
+requires login needs an identity source. `add` then offers to add the missing service first, asks
+for its values, and goes on with the one you named.
+
+With `--yes`, `--json` or without a terminal it never asks: a missing value is an error that names
+the flag to pass, and `--dry-run` shows the change without writing it.
+
 ## Config version 2: create the project, then deploy
 
 ```bash

package/docs/configuration/gateway.md

@@ -194,6 +194,53 @@ npx apitogo secrets set GATEWAY_SECRET
 The value is a reference, never the secret itself. The secret is stored encrypted and never shown
 again. Then make your API refuse any call without that header.
 
+## Run your API on the platform (`managed` origin)
+
+If you have no place to host your API, the platform can run your code. Set the origin mode to
+`managed` and point `source` at the folder with your code:
+
+```json
+"gateway": {
+  "origin": {
+    "mode": "managed",
+    "source": "backend",
+    "runtime": "nodejs",
+    "runtimeVersion": "NODE_22_LTS",
+    "healthPath": "/health",
+    "exclude": ["tests/"]
+  },
+  "specs": ["openapi.json"]
+}
+```
+
+| Field            | Meaning                                                                                                     |
+| ---------------- | ----------------------------------------------------------------------------------------------------------- |
+| `source`         | Folder with your code, relative to the config. Files in its `.gitignore` and in `exclude` are not uploaded. |
+| `runtime`        | `nodejs`, `python` or `dotnet`.                                                                             |
+| `runtimeVersion` | For example `NODE_22_LTS`. The platform lists the allowed values.                                           |
+| `healthPath`     | Path the platform probes to check that your API is up.                                                      |
+| `exclude`        | More paths to leave out, in `.gitignore` syntax.                                                            |
+
+`npx apitogo project create` prepares the hosting for your code. `npx apitogo deploy` then uploads
+the OpenAPI file and the config, uploads your code and waits until it runs, and the gateway starts
+sending calls to it. A deploy with the same code uploads nothing. A .NET project is published for
+you (this needs the .NET SDK on your machine), or you can point `source` at a folder that is already
+published.
+
+Your code can also be reached by its own address, so check that a call came through the gateway. The
+platform gives your code two settings for this: `APITOGO_ORIGIN_SECRET_HEADER` (the header name) and
+`APITOGO_ORIGIN_SECRET` (the value). The gateway sends that header with every call. Refuse any
+request without it, as in
+[Keep your API from being called directly](#keep-your-api-from-being-called-directly):
+
+```js
+const header = process.env.APITOGO_ORIGIN_SECRET_HEADER.toLowerCase();
+if (req.headers[header] !== process.env.APITOGO_ORIGIN_SECRET) {
+  res.writeHead(403).end();
+  return;
+}
+```
+
 ## 4. Try it and check it
 
 Run these before you deploy:
@@ -219,3 +266,8 @@ curl -i https://YOUR-GATEWAY-ADDRESS/orders
 | `404`                           | The path is not in your OpenAPI file.                         |
 | `429`                           | The rate limit was reached.                                   |
 | `502` or `504`                  | Your API did not answer. Check `origin.url` and `healthPath`. |
+
+A change is live a few seconds after `deploy` reports it ready: the gateway keeps answering with the
+previous rules for up to about ten seconds. If a test right after a deploy shows the old behavior,
+wait a moment and try again. The same delay applies when you remove a gateway: its keys stop working
+within seconds, not at the same instant.

package/docs/guides/customer-account.md

@@ -47,8 +47,18 @@ If a payment fails, Stripe retries it. The subscription shows as past due. When
 cancels it, the plan ends and its keys stop working with `401`. The customer is not moved to a free
 plan on their own. They can subscribe to one on the **Plans** page.
 
+## Cancelling and refunds
+
+- **The customer cancels** on the **Plans** page. The subscription ends in Stripe at once, the plan
+  ends and the customer's keys stop working with `401`.
+- **You cancel** a subscription in your Stripe dashboard. Stripe tells the portal, and the plan ends
+  the same way.
+- **A refund** is made in your Stripe dashboard. A refund alone does not end the plan: the customer
+  keeps the key until the subscription is cancelled. Cancel it as well if the customer should lose
+  access. The portal has no refund screen.
+
 What you see is in your own Stripe account: payments, customers and refunds. APItoGo does not take a
-share and does not issue refunds. Tax, trials and refunds are not handled by the portal.
+share and does not issue refunds. Tax and trials are not handled by the portal.
 
 ## API keys
 

package/docs/mcp/tools.md

@@ -1,102 +1,101 @@
----
-title: MCP tools
-description: APItoGo MCP tool catalog by category and hand-edit exceptions.
-sidebar_icon: wrench
----
-
-Tools are exposed by the APItoGo MCP server. Prefer **`apply_product_intent`** for create / shape /
-go-live. Use granular tools for advanced edits, debugging, or CI.
-
-## Lifecycle (prefer these)
-
-| Tool                                 | Role                                           |
-| ------------------------------------ | ---------------------------------------------- |
-| `apply_product_intent`               | Shape or goLive from a product intent          |
-| `create_dev_portal`                  | Scaffold site (+ optional project bootstrap)   |
-| `check_dev_portal_publish_readiness` | Pre-publish checklist                          |
-| `publish_dev_portal`                 | Publish portal + plans (+ optional backend)    |
-| `verify_dev_portal_live`             | Post-publish verification                      |
-| `bootstrap_dev_portal`               | CI one-shot provision + deploy                 |
-| `bootstrap_project`                  | Create platform project only (plan unselected) |
-| `teardown_project`                   | Tear down a project                            |
-
-## Site shaping
-
-| Tool                               | Role                                                                      |
-| ---------------------------------- | ------------------------------------------------------------------------- |
-| `update_dev_portal_manifest`       | Plans, branding, backend, projectId                                       |
-| `set_dev_portal_openapi`           | OpenAPI / API reference                                                   |
-| `set_dev_portal_theme`             | Colors and fonts                                                          |
-| `add_dev_portal_page`              | Add a TSX docs page (site components; `template`: docs\|guide\|marketing) |
-| `update_dev_portal_page`           | Edit a docs page                                                          |
-| `scaffold_dev_portal_landing_page` | Scaffold missing landing file                                             |
-| `get_dev_portal_landing_guide`     | Landing component catalog                                                 |
-| `preview_dev_portal_site`          | Start / restart local preview                                             |
-| `build_dev_portal_site`            | Production build                                                          |
-
-Hosted page CRUD also exists (`list/create/delete/rename/reorder_dev_portal_pages`) for the platform
-API surface.
-
-## Projects and platform billing
-
-| Tool                                        | Role                                  |
-| ------------------------------------------- | ------------------------------------- |
-| `whoami`, `list_projects`, `get_project`, … | Tenant / project CRUD                 |
-| `list_platform_plans`                       | Free / Starter / Professional + quota |
-| `ensure_platform_plan`                      | Select or checkout platform plan      |
-| `wait_for_platform_plan`                    | Poll until active                     |
-| `get_subscription`                          | Current subscription                  |
-| `select_free_plan`                          | Free hosting                          |
-| `create_checkout_session`                   | Stripe checkout for paid hosting      |
-
-## Backend and OpenAPI
-
-| Tool                    | Role                     |
-| ----------------------- | ------------------------ |
-| `validate_openapi`      | Validate OpenAPI         |
-| `update_openapi`        | Update stored OpenAPI    |
-| `package_backend`       | Package backend artifact |
-| `deploy_backend`        | Deploy API hub           |
-| `get_backend_summary`   | Backend status           |
-| `get_deployment_status` | Deployment job status    |
-| `get_gateway_readiness` | Gateway readiness        |
-
-## Gateway
-
-| Tool                                                               | Role                     |
-| ------------------------------------------------------------------ | ------------------------ |
-| `list/get/create/update/patch_gateway_plan`                        | Plan CRUD                |
-| `add_actions_to_gateway_plan` / `remove_actions_from_gateway_plan` | Attach ops               |
-| `set_action_public`                                                | Public routes            |
-| `upsert_entitlement`                                               | Entitlements             |
-| `configure_gateway_baseline`                                       | Baseline policies        |
-| `get/update_gateway_settings`                                      | Settings                 |
-| `get/update_gateway_auth`                                          | Gateway auth             |
-| `sync_gateway_plans_from_manifest`                                 | Post-publish action sync |
-| `reorder_gateway_plans_from_manifest`                              | Plan order               |
-
-## Infrastructure and deploy
-
-| Tool                                                   | Role             |
-| ------------------------------------------------------ | ---------------- |
-| `activate_module`                                      | Activate modules |
-| `get_infrastructure_status` / Azure variants           | Infra status     |
-| `list_provisioning_jobs`, `wait_for_job`               | Jobs             |
-| `get_deployment_token`                                 | CLI deploy token |
-| `get/set/delete_custom_domain`                         | Custom domain    |
-| `get_dev_portal_deploy_config`, `deploy_dev_portal`, … | SWA deploy       |
-
-## Hand-edit exceptions
-
-| Change            | Where                                                    |
-| ----------------- | -------------------------------------------------------- |
-| Home page content | `landing/LandingPage.tsx`                                |
-| Site footer       | `apitogo.config.json` → `modules.landing.content.footer` |
-
-There is **no** `update_dev_portal_landing` tool for arbitrary home content.
-
-## Related
-
-- [Overview](./overview.md)
-- [Shape](./shape.md)
-- [Go live](./go-live.md)
+---
+title: MCP tools
+description: APItoGo MCP tool catalog by category and hand-edit exceptions.
+sidebar_icon: wrench
+---
+
+Tools are exposed by the APItoGo MCP server. Prefer **`apply_product_intent`** for create / shape /
+go-live. Use granular tools for advanced edits, debugging, or CI.
+
+## Lifecycle (prefer these)
+
+| Tool                                 | Role                                           |
+| ------------------------------------ | ---------------------------------------------- |
+| `apply_product_intent`               | Shape or goLive from a product intent          |
+| `create_dev_portal`                  | Scaffold site (+ optional project bootstrap)   |
+| `check_dev_portal_publish_readiness` | Pre-publish checklist                          |
+| `publish_dev_portal`                 | Publish portal + plans (+ optional backend)    |
+| `verify_dev_portal_live`             | Post-publish verification                      |
+| `bootstrap_dev_portal`               | CI one-shot provision + deploy                 |
+| `bootstrap_project`                  | Create platform project only (plan unselected) |
+| `teardown_project`                   | Tear down a project                            |
+
+## Site shaping
+
+| Tool                               | Role                                                                      |
+| ---------------------------------- | ------------------------------------------------------------------------- |
+| `update_dev_portal_manifest`       | Plans, branding, backend, projectId                                       |
+| `set_dev_portal_openapi`           | OpenAPI / API reference                                                   |
+| `set_dev_portal_theme`             | Colors and fonts                                                          |
+| `add_dev_portal_page`              | Add a TSX docs page (site components; `template`: docs\|guide\|marketing) |
+| `update_dev_portal_page`           | Edit a docs page                                                          |
+| `scaffold_dev_portal_landing_page` | Scaffold missing landing file                                             |
+| `get_dev_portal_landing_guide`     | Landing component catalog                                                 |
+| `preview_dev_portal_site`          | Start / restart local preview                                             |
+| `build_dev_portal_site`            | Production build                                                          |
+
+Hosted page CRUD also exists (`list/create/delete/rename/reorder_dev_portal_pages`) for the platform
+API surface.
+
+## Projects and platform billing
+
+| Tool                                        | Role                                  |
+| ------------------------------------------- | ------------------------------------- |
+| `whoami`, `list_projects`, `get_project`, … | Tenant / project CRUD                 |
+| `list_platform_plans`                       | Free / Starter / Professional + quota |
+| `ensure_platform_plan`                      | Select or checkout platform plan      |
+| `wait_for_platform_plan`                    | Poll until active                     |
+| `get_subscription`                          | Current subscription                  |
+| `select_free_plan`                          | Free hosting                          |
+| `create_checkout_session`                   | Stripe checkout for paid hosting      |
+
+## Backend and OpenAPI
+
+| Tool                    | Role                     |
+| ----------------------- | ------------------------ |
+| `validate_openapi`      | Validate OpenAPI         |
+| `update_openapi`        | Update stored OpenAPI    |
+| `package_backend`       | Package backend artifact |
+| `deploy_backend`        | Deploy API hub           |
+| `get_backend_summary`   | Backend status           |
+| `get_deployment_status` | Deployment job status    |
+| `get_gateway_readiness` | Gateway readiness        |
+
+## Gateway
+
+| Tool                                                               | Role                     |
+| ------------------------------------------------------------------ | ------------------------ |
+| `list/get/create/update/patch_gateway_plan`                        | Plan CRUD                |
+| `add_actions_to_gateway_plan` / `remove_actions_from_gateway_plan` | Attach ops               |
+| `set_action_public`                                                | Public routes            |
+| `upsert_entitlement`                                               | Entitlements             |
+| `configure_gateway_baseline`                                       | Baseline policies        |
+| `get/update_gateway_settings`                                      | Settings                 |
+| `get/update_gateway_auth`                                          | Gateway auth             |
+| `sync_gateway_plans_from_manifest`                                 | Post-publish action sync |
+| `reorder_gateway_plans_from_manifest`                              | Plan order               |
+
+## Infrastructure and deploy
+
+| Tool                                                   | Role             |
+| ------------------------------------------------------ | ---------------- |
+| `activate_module`                                      | Activate modules |
+| `get_infrastructure_status` / Azure variants           | Infra status     |
+| `list_provisioning_jobs`, `wait_for_job`               | Jobs             |
+| `get/set/delete_custom_domain`                         | Custom domain    |
+| `get_dev_portal_deploy_config`, `deploy_dev_portal`, … | SWA deploy       |
+
+## Hand-edit exceptions
+
+| Change            | Where                                                    |
+| ----------------- | -------------------------------------------------------- |
+| Home page content | `landing/LandingPage.tsx`                                |
+| Site footer       | `apitogo.config.json` → `modules.landing.content.footer` |
+
+There is **no** `update_dev_portal_landing` tool for arbitrary home content.
+
+## Related
+
+- [Overview](./overview.md)
+- [Shape](./shape.md)
+- [Go live](./go-live.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.2.31",
+  "version": "0.2.34",
   "type": "module",
   "sideEffects": [
     "**/*.css",
@@ -171,6 +171,7 @@
     "build": "esbuild src/cli/cli.ts src/vite/prerender/worker.ts --outdir=dist/cli --entry-names=[name] --bundle --format=esm --packages=external --target=node20 --platform=node --log-level=error",
     "postbuild": "tsx scripts/check-external-deps.ts",
     "typecheck": "tsc --project tsconfig.app.json --noEmit",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
     "generate:types": "tsx scripts/generate-types.js && tsx scripts/generate-flat-config.js",
     "build:standalone": "vite build --mode standalone --config vite.standalone.config.ts --log-level=error",
     "prepack": "npm run build && tsx scripts/generate-publish-exports.ts",

package/src/app/demo.tsx

@@ -1,77 +1,78 @@
-import logger from "loglevel";
-import { createRoot } from "react-dom/client";
-import { createBrowserRouter } from "react-router";
-import type { ZudokuConfig } from "../config/validators/ZudokuConfig.js";
-import { Bootstrap } from "../lib/components/Bootstrap.js";
-import DemoAnnouncement from "../lib/demo/DemoAnnouncement.js";
-import "../lib/util/logInit.js";
-import "./main.css";
-import { openApiPlugin } from "../lib/plugins/openapi/index.js";
-import { getRoutesByConfig } from "./main.js";
-
-const apiUrl = new URL(window.location.href).searchParams.get("api-url");
-const logoUrl = new URL(window.location.href).searchParams.get("logo-url");
-const logoWidth = new URL(window.location.href).searchParams.get("logo-width");
-const title =
-  new URL(window.location.href).searchParams.get("title") ?? "Zudoku Demo";
-
-if (!apiUrl) {
-  throw new Error(
-    "No API URL in query parameters. Please provide an API URL using the `api-url` query parameter.",
-  );
-}
-
-logger.info(`API URL: ${apiUrl}`);
-
-const root =
-  document.getElementById("zudoku") ?? document.getElementById("root");
-
-if (!root) {
-  throw new Error("No div found with id root");
-}
-
-// IMPORTANT: This component must not contain tailwind classes
-// This directory is not processed by the tailwind plugin
-
-const config: ZudokuConfig = {
-  site: {
-    title,
-    banner: {
-      message: <DemoAnnouncement />,
-    },
-  },
-  navigation: [
-    {
-      type: "link",
-      to: "/",
-      label: "API Reference",
-    },
-  ],
-  plugins: [
-    // Using the plugin directly because there's no config file to load in the virtual plugins
-    openApiPlugin({
-      type: "url",
-      input: apiUrl,
-      path: "/",
-    }),
-  ],
-} satisfies ZudokuConfig;
-
-if (logoUrl && logoWidth) {
-  config.site = {
-    ...config.site,
-    logo: {
-      src: {
-        light: logoUrl,
-        dark: logoUrl,
-      },
-      width: logoWidth,
-    },
-  };
-}
-
-const routes = getRoutesByConfig(config);
-const router = createBrowserRouter(routes, {
-  basename: window.location.pathname,
-});
-createRoot(root).render(<Bootstrap router={router} />);
+import logger from "loglevel";
+import { createRoot } from "react-dom/client";
+import { createBrowserRouter } from "react-router";
+import { resolveModulesConfig } from "../config/resolve-modules.js";
+import type { ZudokuConfig } from "../config/validators/ZudokuConfig.js";
+import { Bootstrap } from "../lib/components/Bootstrap.js";
+import "../lib/util/logInit.js";
+import "./main.css";
+import DemoAnnouncement from "../lib/demo/DemoAnnouncement.js";
+import { openApiPlugin } from "../lib/plugins/openapi/index.js";
+import { getRoutesByConfig } from "./main.js";
+
+const apiUrl = new URL(window.location.href).searchParams.get("api-url");
+const logoUrl = new URL(window.location.href).searchParams.get("logo-url");
+const logoWidth = new URL(window.location.href).searchParams.get("logo-width");
+const title =
+  new URL(window.location.href).searchParams.get("title") ?? "Zudoku Demo";
+
+if (!apiUrl) {
+  throw new Error(
+    "No API URL in query parameters. Please provide an API URL using the `api-url` query parameter.",
+  );
+}
+
+logger.info(`API URL: ${apiUrl}`);
+
+const root =
+  document.getElementById("zudoku") ?? document.getElementById("root");
+
+if (!root) {
+  throw new Error("No div found with id root");
+}
+
+// IMPORTANT: This component must not contain tailwind classes
+// This directory is not processed by the tailwind plugin
+
+const config: ZudokuConfig = {
+  site: {
+    title,
+    banner: {
+      message: <DemoAnnouncement />,
+    },
+  },
+  navigation: [
+    {
+      type: "link",
+      to: "/",
+      label: "API Reference",
+    },
+  ],
+  plugins: [
+    // Using the plugin directly because there's no config file to load in the virtual plugins
+    openApiPlugin({
+      type: "url",
+      input: apiUrl,
+      path: "/",
+    }),
+  ],
+} satisfies ZudokuConfig;
+
+if (logoUrl && logoWidth) {
+  config.site = {
+    ...config.site,
+    logo: {
+      src: {
+        light: logoUrl,
+        dark: logoUrl,
+      },
+      width: logoWidth,
+    },
+  };
+}
+
+const routes = getRoutesByConfig(config, resolveModulesConfig);
+const router = createBrowserRouter(routes, {
+  basename: window.location.pathname,
+});
+createRoot(root).render(<Bootstrap router={router} />);