create-mdan 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MDAN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# create-mdan
+
+`create-mdan` scaffolds a minimal MDAN app.
+
+Use it when you want the fastest path from a blank directory to a working MDAN app.
+
+It supports both Node and Bun starters.
+
+## Usage
+
+Node starter:
+
+```bash
+npm create mdan@latest agent-app
+cd agent-app
+npm install
+npm start
+```
+
+Bun starter:
+
+```bash
+bunx create-mdan agent-app
+cd agent-app
+bun install
+bun start
+```
+
+You can override the generated runtime explicitly:
+
+```bash
+npm create mdan@latest agent-app -- --runtime bun
+bunx create-mdan agent-app --runtime node
+```
+
+Defaults:
+
+- `npm create` and `npx create-mdan` default to the Node starter
+- `bunx create-mdan` defaults to the Bun starter
+
+The generated app uses this small shape:
+
+- `app/index.md`
+- `app/server.ts`
+- `app/client.ts`
+- `index.mjs`
+
+## Docs
+
+- [Docs](https://docs.mdan.ai/)
+- [Getting Started](https://docs.mdan.ai/getting-started)
+- [Understanding MDAN](https://docs.mdan.ai/understanding-mdan)
+- [Examples](https://docs.mdan.ai/examples)
+- [SDK Overview](https://docs.mdan.ai/sdk)

package/dist/cli-bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli-bin.d.ts.map

package/dist/cli-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-bin.d.ts","sourceRoot":"","sources":["../src/cli-bin.ts"],"names":[],"mappings":""}

package/dist/cli-bin.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { main } from "./cli.js";
+main(process.argv.slice(2)).catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli-bin.js.map

package/dist/cli-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-bin.js","sourceRoot":"","sources":["../src/cli-bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+import { type StarterRuntime } from "./index.js";
+export interface ParsedCliArgs {
+    targetArg: string | undefined;
+    runtime: StarterRuntime;
+    showHelp: boolean;
+}
+export declare function detectDefaultRuntime(userAgent?: string): StarterRuntime;
+export declare function parseCliArgs(argv: string[], userAgent?: string): ParsedCliArgs;
+export declare function formatUsage(): string;
+export declare function formatNextSteps(projectDir: string, runtime: StarterRuntime, targetArg?: string): string;
+declare function main(argv: string[]): Promise<void>;
+export { main };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgD,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAgB,oBAAoB,CAAC,SAAS,SAA0C,GAAG,cAAc,CAExG;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,SAA0C,GAAG,aAAa,CAkD/G;AAED,wBAAgB,WAAW,IAAI,MAAM,CAQpC;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,SAAa,GAAG,MAAM,CAa3G;AAMD,iBAAe,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjD;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/cli.js

@@ -0,0 +1,94 @@
+import { resolve } from "node:path";
+import packageJson from "../package.json" with { type: "json" };
+import { scaffoldStarterProject, toCompatibleSdkRange } from "./index.js";
+function isStarterRuntime(value) {
+    return value === "node" || value === "bun";
+}
+export function detectDefaultRuntime(userAgent = process.env.npm_config_user_agent ?? "") {
+    return /\bbun\/\d/i.test(userAgent) ? "bun" : "node";
+}
+export function parseCliArgs(argv, userAgent = process.env.npm_config_user_agent ?? "") {
+    let targetArg;
+    let runtime = detectDefaultRuntime(userAgent);
+    let showHelp = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            showHelp = true;
+            continue;
+        }
+        if (arg === "--") {
+            continue;
+        }
+        if (arg === "--runtime") {
+            const next = argv[index + 1];
+            if (!next || !isStarterRuntime(next)) {
+                throw new Error('Expected "--runtime" to be followed by "node" or "bun".');
+            }
+            runtime = next;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--runtime=")) {
+            const value = arg.slice("--runtime=".length);
+            if (!isStarterRuntime(value)) {
+                throw new Error(`Unsupported runtime "${value}". Expected "node" or "bun".`);
+            }
+            runtime = value;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            throw new Error(`Unknown option "${arg}".`);
+        }
+        if (targetArg) {
+            throw new Error(`Unexpected extra argument "${arg}".`);
+        }
+        targetArg = arg;
+    }
+    return { targetArg, runtime, showHelp };
+}
+export function formatUsage() {
+    return [
+        "Usage:",
+        "  npm create mdan@latest <project-name>",
+        "  npm create mdan@latest <project-name> -- --runtime bun",
+        "  bunx create-mdan <project-name>",
+        "  bunx create-mdan <project-name> --runtime node"
+    ].join("\n");
+}
+export function formatNextSteps(projectDir, runtime, targetArg = projectDir) {
+    const installCommand = runtime === "bun" ? "bun install" : "npm install";
+    const startCommand = runtime === "bun" ? "bun start" : "npm start";
+    return [
+        `Created MDAN ${runtime} starter in ${projectDir}`,
+        "",
+        "Next steps:",
+        `  cd ${targetArg}`,
+        "",
+        `  ${installCommand}`,
+        `  ${startCommand}`
+    ].join("\n");
+}
+function printUsage() {
+    console.log(formatUsage());
+}
+async function main(argv) {
+    const { targetArg, runtime, showHelp } = parseCliArgs(argv);
+    if (!targetArg || showHelp) {
+        printUsage();
+        return;
+    }
+    const targetDir = resolve(process.cwd(), targetArg);
+    const projectDir = await scaffoldStarterProject({
+        targetDir,
+        sdkVersion: toCompatibleSdkRange(packageJson.version),
+        runtime,
+        ...(targetArg === "." ? {} : { projectName: targetArg })
+    });
+    console.log(formatNextSteps(projectDir, runtime, targetArg));
+}
+export { main };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type StarterRuntime = "node" | "bun";
+export interface ScaffoldStarterProjectOptions {
+    targetDir: string;
+    projectName?: string;
+    sdkVersion: string;
+    runtime?: StarterRuntime;
+}
+export declare function toCompatibleSdkRange(packageVersion: string): string;
+export declare function scaffoldStarterProject(options: ScaffoldStarterProjectOptions, moduleUrl?: string): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AASD,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAQnE;AAsDD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,EACtC,SAAS,SAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/index.js

@@ -0,0 +1,86 @@
+import { cp, mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const TEMPLATE_PLACEHOLDERS = {
+    __PROJECT_NAME__: "",
+    __SDK_VERSION__: ""
+};
+const DEFAULT_RUNTIME = "node";
+export function toCompatibleSdkRange(packageVersion) {
+    const match = packageVersion.match(/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
+    if (!match) {
+        throw new Error(`Unsupported package version "${packageVersion}".`);
+    }
+    const [, major, minor] = match;
+    return `^${major}.${minor}.0`;
+}
+function templateRootsFromModule(moduleUrl, runtime) {
+    return [
+        resolve(fileURLToPath(new URL("../template/shared", moduleUrl))),
+        resolve(fileURLToPath(new URL(`../template/${runtime}`, moduleUrl)))
+    ];
+}
+async function ensureEmptyTarget(targetDir) {
+    try {
+        const targetStat = await stat(targetDir);
+        if (!targetStat.isDirectory()) {
+            throw new Error(`Target path "${targetDir}" already exists and is not a directory.`);
+        }
+        const entries = await readdir(targetDir);
+        if (entries.length > 0) {
+            throw new Error(`Target directory "${targetDir}" must be empty.`);
+        }
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            await mkdir(targetDir, { recursive: true });
+            return;
+        }
+        throw error;
+    }
+}
+async function replaceInFile(filePath, replacements) {
+    const original = await readFile(filePath, "utf8");
+    let next = original;
+    for (const [pattern, value] of Object.entries(replacements)) {
+        next = next.replaceAll(pattern, value);
+    }
+    if (next !== original) {
+        await writeFile(filePath, next, "utf8");
+    }
+}
+async function walkFiles(root) {
+    const entries = await readdir(root, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const filePath = join(root, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await walkFiles(filePath)));
+            continue;
+        }
+        files.push(filePath);
+    }
+    return files;
+}
+export async function scaffoldStarterProject(options, moduleUrl = import.meta.url) {
+    const runtime = options.runtime ?? DEFAULT_RUNTIME;
+    const templateRoots = templateRootsFromModule(moduleUrl, runtime);
+    const targetDir = resolve(options.targetDir);
+    const projectName = options.projectName?.trim() || basename(targetDir);
+    if (!projectName) {
+        throw new Error("Project name cannot be empty.");
+    }
+    await ensureEmptyTarget(targetDir);
+    for (const templateRoot of templateRoots) {
+        await cp(templateRoot, targetDir, { recursive: true });
+    }
+    const replacements = {
+        __PROJECT_NAME__: projectName,
+        __SDK_VERSION__: options.sdkVersion
+    };
+    const files = await walkFiles(targetDir);
+    await Promise.all(files.map((filePath) => replaceInFile(filePath, replacements)));
+    return targetDir;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "create-mdan",
+  "version": "0.5.0",
+  "private": false,
+  "description": "Create a minimal MDAN app with npm create or bunx.",
+  "license": "MIT",
+  "homepage": "https://docs.mdan.ai",
+  "bugs": {
+    "url": "https://github.com/mdan-ai/mdan/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mdan-ai/mdan.git"
+  },
+  "keywords": [
+    "mdan",
+    "create",
+    "scaffold",
+    "markdown",
+    "ai",
+    "agent",
+    "agentic",
+    "workflow",
+    "skills-app",
+    "agent-app",
+    "cli",
+    "bun"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "template/shared",
+    "template/node",
+    "template/bun"
+  ],
+  "bin": {
+    "create-mdan": "./dist/cli-bin.js"
+  },
+  "scripts": {
+    "prepack": "node ../scripts/sync-package-license.mjs",
+    "postpack": "node ../scripts/sync-package-license.mjs --cleanup"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}

package/template/bun/README.md

@@ -0,0 +1,31 @@
+# __PROJECT_NAME__
+
+This is a minimal MDAN starter for the Bun host.
+
+## 30-Second Tour
+
+- `app/index.md`
+  Defines the page source and interaction.
+- `app/server.ts`
+  Owns state and action handlers.
+- `app/client.ts`
+  Mounts the browser runtime.
+- `index.mjs`
+  Starts the Bun host.
+
+## Run It
+
+```bash
+bun install
+bun start
+```
+
+This starter is Bun-native, so you can use it without installing Node.
+
+Then open [http://127.0.0.1:3000/](http://127.0.0.1:3000/).
+
+## First Things To Change
+
+1. Edit `app/index.md`
+2. Edit `app/server.ts`
+3. Keep `app/client.ts` as-is, or replace it when you want to own the UI

package/template/bun/index.mjs

@@ -0,0 +1,63 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createHost } from "@mdanai/sdk/server/bun";
+
+import { createAppServer } from "./dist/server.js";
+
+const port = Number(process.env.PORT || 3000);
+const hostname = process.env.HOST || "127.0.0.1";
+const projectRoot = fileURLToPath(new URL("./", import.meta.url));
+const sourcePath = join(projectRoot, "app", "index.md");
+const assetVersion = Date.now().toString(36);
+
+function withVersion(path) {
+  return `${path}?v=${assetVersion}`;
+}
+
+const importMap = {
+  imports: {
+    "@mdanai/sdk/core": withVersion("/node_modules/@mdanai/sdk/dist/core/index.js"),
+    "@mdanai/sdk/web": withVersion("/node_modules/@mdanai/sdk/dist/web/index.js"),
+    "@mdanai/sdk/elements": withVersion("/node_modules/@mdanai/sdk/dist/elements/index.js"),
+    "lit": withVersion("/node_modules/lit/index.js"),
+    "lit-html": withVersion("/node_modules/lit-html/lit-html.js"),
+    "lit-html/is-server.js": withVersion("/node_modules/lit-html/is-server.js"),
+    "lit-element/lit-element.js": withVersion("/node_modules/lit-element/lit-element.js"),
+    "@lit/reactive-element": withVersion("/node_modules/@lit/reactive-element/reactive-element.js")
+  }
+};
+
+function injectEnhancement(html) {
+  const enhancement = `
+<script type="importmap">${JSON.stringify(importMap)}</script>
+<script type="module">
+  import { mountApp } from "${withVersion("/app/client.js")}";
+  mountApp(document, window.fetch.bind(window));
+</script>`;
+
+  return html.replace("</body>", `${enhancement}\n  </body>`);
+}
+
+const source = await readFile(sourcePath, "utf8");
+const mdan = createAppServer({ source });
+
+Bun.serve({
+  hostname,
+  port,
+  fetch: createHost(mdan, {
+    transformHtml: injectEnhancement,
+    staticFiles: {
+      "/app/client.js": join(projectRoot, "dist", "client.js")
+    },
+    staticMounts: [
+      {
+        urlPrefix: "/node_modules/",
+        directory: join(projectRoot, "node_modules")
+      }
+    ]
+  })
+});
+
+console.log(`MDAN starter running at http://${hostname}:${port}/`);

package/template/bun/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "tsc -p tsconfig.json && bun run index.mjs"
+  },
+  "dependencies": {
+    "@mdanai/sdk": "__SDK_VERSION__"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  }
+}

package/template/node/README.md

@@ -0,0 +1,29 @@
+# __PROJECT_NAME__
+
+This is a minimal MDAN starter for the Node host.
+
+## 30-Second Tour
+
+- `app/index.md`
+  Defines the page source and interaction.
+- `app/server.ts`
+  Owns state and action handlers.
+- `app/client.ts`
+  Mounts the browser runtime.
+- `index.mjs`
+  Starts the Node host.
+
+## Run It
+
+```bash
+npm install
+npm start
+```
+
+Then open [http://127.0.0.1:3000/](http://127.0.0.1:3000/).
+
+## First Things To Change
+
+1. Edit `app/index.md`
+2. Edit `app/server.ts`
+3. Keep `app/client.ts` as-is, or replace it when you want to own the UI

package/template/node/index.mjs

@@ -0,0 +1,62 @@
+import http from "node:http";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createHost } from "@mdanai/sdk/server/node";
+
+import { createAppServer } from "./dist/server.js";
+
+const port = Number(process.env.PORT || 3000);
+const projectRoot = fileURLToPath(new URL("./", import.meta.url));
+const sourcePath = join(projectRoot, "app", "index.md");
+const assetVersion = Date.now().toString(36);
+
+function withVersion(path) {
+  return `${path}?v=${assetVersion}`;
+}
+
+const importMap = {
+  imports: {
+    "@mdanai/sdk/core": withVersion("/node_modules/@mdanai/sdk/dist/core/index.js"),
+    "@mdanai/sdk/web": withVersion("/node_modules/@mdanai/sdk/dist/web/index.js"),
+    "@mdanai/sdk/elements": withVersion("/node_modules/@mdanai/sdk/dist/elements/index.js"),
+    "lit": withVersion("/node_modules/lit/index.js"),
+    "lit-html": withVersion("/node_modules/lit-html/lit-html.js"),
+    "lit-html/is-server.js": withVersion("/node_modules/lit-html/is-server.js"),
+    "lit-element/lit-element.js": withVersion("/node_modules/lit-element/lit-element.js"),
+    "@lit/reactive-element": withVersion("/node_modules/@lit/reactive-element/reactive-element.js")
+  }
+};
+
+function injectEnhancement(html) {
+  const enhancement = `
+<script type="importmap">${JSON.stringify(importMap)}</script>
+<script type="module">
+  import { mountApp } from "${withVersion("/app/client.js")}";
+  mountApp(document, window.fetch.bind(window));
+</script>`;
+
+  return html.replace("</body>", `${enhancement}\n  </body>`);
+}
+
+const source = await readFile(sourcePath, "utf8");
+const mdan = createAppServer({ source });
+const server = http.createServer(
+  createHost(mdan, {
+    transformHtml: injectEnhancement,
+    staticFiles: {
+      "/app/client.js": join(projectRoot, "dist", "client.js")
+    },
+    staticMounts: [
+      {
+        urlPrefix: "/node_modules/",
+        directory: join(projectRoot, "node_modules")
+      }
+    ]
+  })
+);
+
+server.listen(port, "127.0.0.1", () => {
+  console.log(`MDAN starter running at http://127.0.0.1:${port}/`);
+});

package/template/node/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "tsc -p tsconfig.json && node index.mjs"
+  },
+  "dependencies": {
+    "@mdanai/sdk": "__SDK_VERSION__"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  }
+}

package/template/shared/app/client.ts

@@ -0,0 +1,7 @@
+import { mountMdanElements } from "@mdanai/sdk/elements";
+import { createHeadlessHost } from "@mdanai/sdk/web";
+
+export function mountApp(root: HTMLElement, fetchImpl: typeof fetch): void {
+  const host = createHeadlessHost({ root, fetchImpl });
+  mountMdanElements({ root, host }).mount();
+}

package/template/shared/app/index.md

@@ -0,0 +1,17 @@
+---
+title: "Agent App"
+---
+
+# Agent App
+
+Use this starter as the smallest end-to-end MDAN app.
+
+<!-- mdan:block main -->
+
+```mdan
+BLOCK main {
+  INPUT text required -> message
+  GET "/list" -> refresh label:"Refresh"
+  POST "/post" (message) -> submit label:"Submit"
+}
+```

package/template/shared/app/server.ts

@@ -0,0 +1,51 @@
+import { composePage } from "@mdanai/sdk/core";
+import { createHostedApp } from "@mdanai/sdk/server";
+
+export interface CreateAppServerOptions {
+  source: string;
+  initialMessages?: string[];
+}
+
+export function createAppServer(options: CreateAppServerOptions) {
+  const messages = [...(options.initialMessages ?? ["Welcome to MDAN"])];
+
+  function renderMainBlock(): string {
+    const count = `${messages.length} live ${messages.length === 1 ? "message" : "messages"}`;
+    return `## ${count}\n\n${messages.map((message) => `- ${message}`).join("\n")}`;
+  }
+
+  function renderPage() {
+    return composePage(options.source, {
+      blocks: {
+        main: renderMainBlock()
+      }
+    });
+  }
+
+  return createHostedApp({
+    pages: {
+      "/": renderPage
+    },
+    actions: [
+      {
+        target: "/list",
+        methods: ["GET"],
+        routePath: "/",
+        blockName: "main",
+        handler: ({ block }) => block()
+      },
+      {
+        target: "/post",
+        methods: ["POST"],
+        routePath: "/",
+        blockName: "main",
+        handler: ({ inputs, block }) => {
+          if (inputs.message) {
+            messages.push(inputs.message);
+          }
+          return block();
+        }
+      }
+    ]
+  });
+}

package/template/shared/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "lib": ["ES2022", "DOM"],
+    "types": ["node"],
+    "rootDir": "./app",
+    "outDir": "./dist"
+  },
+  "include": ["app/**/*.ts"]
+}