@owlmeans/create-app 0.1.10

package/README.md

@@ -0,0 +1,59 @@
+# @owlmeans/create-app
+
+Scaffold a minimal **fullstack OwlMeans Common** app in one command.
+
+```sh
+npm create @owlmeans/app@latest my-app
+# or
+bun create @owlmeans/app my-app
+# or
+yarn create @owlmeans/app my-app
+# or
+npx @owlmeans/create-app my-app
+```
+
+## What it generates
+
+A bun-workspace monorepo with three packages and **no authentication**:
+
+```
+my-app/
+├── sources/
+│   ├── common/   # shared entrypoints (routes), schemas and types
+│   ├── api/      # @owlmeans/server-app backend; session data in an in-memory static resource
+│   └── web/      # @owlmeans/web-panel + shadcn UI: navigation, layout and screens
+```
+
+The web app ships a basic shadcn UI **navigation + layout** and a **Session** screen
+that creates, lists and removes items held in a **session-scoped in-memory resource**
+(`@owlmeans/static-resource`) on the backend — no database required.
+
+By default the scaffolder also installs dependencies and **deploys agent guidance**
+into the project via [`@owlmeans/agent-skills`](https://www.npmjs.com/package/@owlmeans/agent-skills)
+(`.claude/skills/` + `.github/instructions/`).
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--name <name>` | Human-readable app name (default: derived from the target dir) |
+| `--pm <bun\|npm\|yarn>` | Package manager (default: `bun`) |
+| `--no-install` | Skip dependency installation |
+| `--no-skills` | Skip the `@owlmeans/agent-skills` deploy |
+| `--no-git` | Skip `git init` |
+| `--yes`, `-y` | Proceed without prompts / into a non-empty directory |
+| `--help`, `-h` | Show help |
+
+## Running the generated app
+
+```sh
+cd my-app
+bun install      # if you passed --no-install
+bun run dev      # api on :3000, web on :3001
+```
+
+## Doing it manually instead
+
+Prefer to wire it up by hand? Follow
+[docs/getting-started.md](https://github.com/owlmeans/common/blob/main/docs/getting-started.md),
+which documents both the scaffolded and the manual path step by step.

package/build/args.d.ts

@@ -0,0 +1,21 @@
+export type PackageManager = 'bun' | 'npm' | 'yarn';
+export interface CreateArgs {
+    /** Target directory (positional). `null` means it must be prompted/derived. */
+    dir: string | null;
+    /** Human-readable app name. Defaults to the directory slug. */
+    name: string | null;
+    /** Package manager used to install deps and (for `bun`) run the project. */
+    pm: PackageManager;
+    /** Install dependencies after copying the template. */
+    install: boolean;
+    /** Deploy agent skills via @owlmeans/agent-skills after install. */
+    skills: boolean;
+    /** Run `git init` in the new project. */
+    git: boolean;
+    /** Skip confirmations / proceed into a non-empty directory. */
+    yes: boolean;
+    help: boolean;
+}
+export declare const parseArgs: (argv: string[]) => CreateArgs | null;
+export declare const printHelp: () => void;
+//# sourceMappingURL=args.d.ts.map

package/build/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AAEnD,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,4EAA4E;IAC5E,EAAE,EAAE,cAAc,CAAA;IAClB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAA;IACf,yCAAyC;IACzC,GAAG,EAAE,OAAO,CAAA;IACZ,+DAA+D;IAC/D,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AA0BD,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UAAU,GAAG,IAsEvD,CAAA;AAED,eAAO,MAAM,SAAS,QAAO,IAE5B,CAAA"}

package/build/args.js

@@ -0,0 +1,96 @@
+const HELP = `@owlmeans/create-app — scaffold a fullstack OwlMeans Common app
+
+Usage:
+  npm create @owlmeans/app@latest <dir> [options]
+  bun create @owlmeans/app <dir> [options]
+  yarn create @owlmeans/app <dir> [options]
+  npx @owlmeans/create-app <dir> [options]
+
+Generates three workspaces (common + api + web) with shadcn UI navigation and
+layout, no authentication, and a session-scoped in-memory resource on the
+backend. Agent skills are deployed into the project by default.
+
+Options:
+  --name <name>       human-readable app name (default: derived from <dir>)
+  --pm <bun|npm|yarn> package manager (default: bun)
+  --no-install        do not install dependencies
+  --no-skills         do not deploy agent skills via @owlmeans/agent-skills
+  --no-git            do not run "git init"
+  --yes, -y           proceed without prompts / into a non-empty directory
+  --help, -h          show this help
+`;
+const PMS = ['bun', 'npm', 'yarn'];
+export const parseArgs = (argv) => {
+    const args = argv.slice(2);
+    const result = {
+        dir: null,
+        name: null,
+        pm: 'bun',
+        install: true,
+        skills: true,
+        git: true,
+        yes: false,
+        help: false,
+    };
+    let i = 0;
+    while (i < args.length) {
+        const a = args[i];
+        switch (a) {
+            case '--help':
+            case '-h':
+                result.help = true;
+                break;
+            case '--yes':
+            case '-y':
+                result.yes = true;
+                break;
+            case '--no-install':
+                result.install = false;
+                break;
+            case '--no-skills':
+                result.skills = false;
+                break;
+            case '--no-git':
+                result.git = false;
+                break;
+            case '--name': {
+                const v = args[i + 1];
+                if (v == null || v.startsWith('-')) {
+                    process.stderr.write('error: --name requires a value\n');
+                    return null;
+                }
+                result.name = v;
+                i++;
+                break;
+            }
+            case '--pm': {
+                const v = args[i + 1];
+                if (v == null || !PMS.includes(v)) {
+                    process.stderr.write(`error: --pm must be one of ${PMS.join(', ')}\n`);
+                    return null;
+                }
+                result.pm = v;
+                i++;
+                break;
+            }
+            default:
+                if (a.startsWith('-')) {
+                    process.stderr.write(`error: unknown flag ${a}\n`);
+                    return null;
+                }
+                if (result.dir == null) {
+                    result.dir = a;
+                }
+                else {
+                    process.stderr.write(`error: unexpected argument ${a}\n`);
+                    return null;
+                }
+        }
+        i++;
+    }
+    return result;
+};
+export const printHelp = () => {
+    process.stdout.write(HELP);
+};
+//# sourceMappingURL=args.js.map

package/build/args.js.map

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

package/build/bin.d.ts

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

package/build/bin.d.ts.map

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

package/build/bin.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { parseArgs, printHelp } from './args.js';
+import { run } from './run.js';
+const args = parseArgs(process.argv);
+if (args == null) {
+    process.stderr.write('Run with --help for usage.\n');
+    process.exit(2);
+}
+else if (args.help) {
+    printHelp();
+    process.exit(0);
+}
+else {
+    run(args).then(code => {
+        process.exit(code);
+    }).catch((err) => {
+        process.stderr.write(`fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=bin.js.map

package/build/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAEpC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;KAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,SAAS,EAAE,CAAA;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;KAAM,CAAC;IACN,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,6 @@
+export { run } from './run.js';
+export { parseArgs, printHelp } from './args.js';
+export type { CreateArgs, PackageManager } from './args.js';
+export { copyTemplate, templateDir, isEmptyDir } from './template.js';
+export type { TemplateReplacements } from './template.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAChD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}

package/build/index.js

@@ -0,0 +1,4 @@
+export { run } from './run.js';
+export { parseArgs, printHelp } from './args.js';
+export { copyTemplate, templateDir, isEmptyDir } from './template.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/build/run.d.ts

@@ -0,0 +1,3 @@
+import type { CreateArgs } from './args.js';
+export declare const run: (args: CreateArgs) => Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/build/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAA;AAiB3D,eAAO,MAAM,GAAG,GAAU,MAAM,UAAU,KAAG,OAAO,CAAC,MAAM,CAwE1D,CAAA"}

package/build/run.js

@@ -0,0 +1,81 @@
+import { spawnSync } from 'node:child_process';
+import { basename, resolve } from 'node:path';
+import { run as installSkills } from '@owlmeans/agent-skills';
+import { copyTemplate, isEmptyDir, templateDir } from './template.js';
+const slugify = (input) => basename(input)
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    || 'owlmeans-app';
+const titleize = (slug) => slug.split('-').filter(Boolean).map(w => w[0].toUpperCase() + w.slice(1)).join(' ');
+const installArgs = (pm) => pm === 'yarn' ? [] : ['install'];
+const log = (msg) => { process.stdout.write(msg + '\n'); };
+export const run = async (args) => {
+    if (args.dir == null) {
+        process.stderr.write('error: target directory is required, e.g. `create-app my-app`\n');
+        return 2;
+    }
+    const dest = resolve(args.dir);
+    const slug = slugify(args.dir);
+    const name = args.name ?? titleize(slug);
+    if (!isEmptyDir(dest) && !args.yes) {
+        process.stderr.write(`error: ${dest} is not empty. Re-run with --yes to scaffold into it anyway.\n`);
+        return 1;
+    }
+    log(`\nScaffolding OwlMeans app "${name}" into ${dest}\n`);
+    copyTemplate(templateDir(), dest, { slug, name });
+    log('  ✓ template copied (common + api + web)');
+    if (args.git) {
+        const git = spawnSync('git', ['init', '-q'], { cwd: dest, stdio: 'ignore' });
+        if (git.status === 0)
+            log('  ✓ git repository initialized');
+    }
+    if (args.install) {
+        log(`\nInstalling dependencies with ${args.pm}…`);
+        const res = spawnSync(args.pm, installArgs(args.pm), { cwd: dest, stdio: 'inherit' });
+        if (res.status !== 0) {
+            process.stderr.write(`\nwarning: "${args.pm} install" failed — run it manually in ${dest}.\n`);
+        }
+        else {
+            log('  ✓ dependencies installed');
+        }
+    }
+    if (args.skills) {
+        if (!args.install) {
+            log('\nSkipping agent-skills deploy (requires installed dependencies — re-run with install).');
+        }
+        else {
+            log('\nDeploying agent skills via @owlmeans/agent-skills…');
+            try {
+                const result = await installSkills({
+                    dir: dest,
+                    yes: true,
+                    only: [],
+                    claudeOnly: false,
+                    copilotOnly: false,
+                    extras: true,
+                    force: false,
+                    dryRun: false,
+                    help: false,
+                });
+                if (result.code !== 0) {
+                    process.stderr.write(`  agent-skills exited with code ${result.code} — you can re-run \`npx @owlmeans/agent-skills\` later.\n`);
+                }
+            }
+            catch (err) {
+                process.stderr.write(`  agent-skills failed: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+    }
+    const runCmd = args.pm === 'npm' ? 'npm run dev' : `${args.pm} run dev`;
+    const installCmd = args.pm === 'yarn' ? 'yarn' : `${args.pm} install`;
+    log(`\nDone. Next steps:\n`);
+    log(`  cd ${args.dir}`);
+    if (!args.install)
+        log(`  ${installCmd}`);
+    log(`  ${runCmd}\n`);
+    log('The web app starts on http://localhost:3001 and the API on http://localhost:3000.');
+    log('Open the "Session" page to exercise the in-memory session resource.\n');
+    return 0;
+};
+//# sourceMappingURL=run.js.map

package/build/run.js.map

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

package/build/template.d.ts

@@ -0,0 +1,17 @@
+import { renameSync } from 'node:fs';
+export interface TemplateReplacements {
+    /** package/workspace slug, e.g. `my-app` */
+    slug: string;
+    /** human-readable name, e.g. `My App` */
+    name: string;
+}
+/** Absolute path to the bundled `template/` directory (sibling of `build/`). */
+export declare const templateDir: () => string;
+/**
+ * Recursively copy `src` → `dest`, substituting `__APP_SLUG__` / `__APP_NAME__`
+ * in text files and renaming shipped dotfiles (`_gitignore` → `.gitignore`).
+ */
+export declare const copyTemplate: (src: string, dest: string, r: TemplateReplacements) => void;
+export declare const isEmptyDir: (dir: string) => boolean;
+export { renameSync };
+//# sourceMappingURL=template.d.ts.map

package/build/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4D,UAAU,EAA2B,MAAM,SAAS,CAAA;AAcvH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAO,MACqC,CAAA;AAYpE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,EAAE,GAAG,oBAAoB,KAAG,IAoBjF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,OAGxC,CAAA;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/build/template.js

@@ -0,0 +1,49 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join, resolve } from 'node:path';
+/** Dotfiles are shipped with an underscore prefix so npm does not strip them from the tarball. */
+const DOTFILE_RENAMES = {
+    '_gitignore': '.gitignore',
+    '_npmrc': '.npmrc',
+    '_env': '.env',
+};
+/** Files whose contents are binary or must not be string-substituted. */
+const BINARY_EXT = new Set(['.ico', '.png', '.jpg', '.jpeg', '.gif', '.webp', '.woff', '.woff2']);
+/** Absolute path to the bundled `template/` directory (sibling of `build/`). */
+export const templateDir = () => resolve(dirname(fileURLToPath(import.meta.url)), '..', 'template');
+const applyReplacements = (content, r) => content
+    .replaceAll('__APP_SLUG__', r.slug)
+    .replaceAll('__APP_NAME__', r.name);
+const isBinary = (file) => {
+    const dot = file.lastIndexOf('.');
+    return dot >= 0 && BINARY_EXT.has(file.slice(dot).toLowerCase());
+};
+/**
+ * Recursively copy `src` → `dest`, substituting `__APP_SLUG__` / `__APP_NAME__`
+ * in text files and renaming shipped dotfiles (`_gitignore` → `.gitignore`).
+ */
+export const copyTemplate = (src, dest, r) => {
+    mkdirSync(dest, { recursive: true });
+    for (const entry of readdirSync(src)) {
+        const from = join(src, entry);
+        const targetName = DOTFILE_RENAMES[entry] ?? entry;
+        const to = join(dest, targetName);
+        if (statSync(from).isDirectory()) {
+            copyTemplate(from, to, r);
+            continue;
+        }
+        if (isBinary(from)) {
+            cpSync(from, to);
+            continue;
+        }
+        const content = applyReplacements(readFileSync(from, 'utf8'), r);
+        writeFileSync(to, content);
+    }
+};
+export const isEmptyDir = (dir) => {
+    if (!existsSync(dir))
+        return true;
+    return readdirSync(dir).length === 0;
+};
+export { renameSync };
+//# sourceMappingURL=template.js.map

package/build/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElD,kGAAkG;AAClG,MAAM,eAAe,GAA2B;IAC9C,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,MAAM;CACf,CAAA;AAED,yEAAyE;AACzE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AASjG,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CACtC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAA;AAEpE,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,CAAuB,EAAU,EAAE,CAC7E,OAAO;KACJ,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC;KAClC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;AAEvC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAW,EAAE;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACjC,OAAO,GAAG,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;AAClE,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,IAAY,EAAE,CAAuB,EAAQ,EAAE;IACvF,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC7B,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,CAAA;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAEjC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACjC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;YACzB,SAAQ;QACV,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;YAChB,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QAChE,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAW,EAAE;IACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACjC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;AACtC,CAAC,CAAA;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@owlmeans/create-app",
+  "version": "0.1.10",
+  "license": "MIT",
+  "description": "Scaffold a minimal fullstack OwlMeans Common app — common + api + web workspaces, shadcn UI navigation/layout, no auth, and a session-scoped in-memory resource. Deploys agent skills via @owlmeans/agent-skills by default.",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "bin": {
+    "create-app": "./build/bin.js"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "files": [
+    "build",
+    "template"
+  ],
+  "dependencies": {
+    "@owlmeans/agent-skills": "^0.1.10"
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
+    "@types/node": "^24.10.1",
+    "nodemon": "^3.1.11",
+    "typescript": "^6.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/template/README.md

@@ -0,0 +1,51 @@
+# __APP_NAME__
+
+A minimal fullstack [OwlMeans Common](https://github.com/owlmeans/common) app, scaffolded with
+[`@owlmeans/create-app`](https://www.npmjs.com/package/@owlmeans/create-app).
+
+No authentication; session data lives in an **in-memory static resource** on the backend.
+
+## Workspaces
+
+```
+sources/
+├── common/   # shared entrypoints (routes), schemas and types — used by api AND web
+├── api/      # @owlmeans/server-app backend; session items in @owlmeans/static-resource
+└── web/      # @owlmeans/web-panel + shadcn UI: navigation, layout and screens
+```
+
+## Develop
+
+```sh
+bun install
+bun run dev
+```
+
+- API: http://localhost:3000
+- Web: http://localhost:3001
+
+Open the **Session** page and add/remove items — they are stored per browser session
+(a `sid` kept in `localStorage`) in an in-memory resource on the API. Restarting the API
+clears them; opening a different browser/incognito window gets an isolated session.
+
+## How it fits together
+
+1. **`sources/common`** declares the API routes as OwlMeans *entrypoints* (`session.list`,
+   `session.add`, `session.remove`) plus their AJV schemas and shared types.
+2. **`sources/api`** registers a `@owlmeans/static-resource` in its context and `elevate()`s
+   each entrypoint with a handler that does CRUD against it, keyed by the session id.
+3. **`sources/web`** `elevate()`s the same entrypoints to screen components and calls them with
+   `context.entrypoint(alias).call({ params, body })`.
+
+See [OwlMeans getting-started guide](https://github.com/owlmeans/common/blob/main/docs/getting-started.md)
+for a full walkthrough and the manual (non-scaffolded) version of this project.
+
+## Agent guidance
+
+This project ships Claude Code skills (`.claude/skills/`) and GitHub Copilot instructions
+(`.github/instructions/`) for the OwlMeans framework. Refresh them after upgrading
+`@owlmeans/*` packages:
+
+```sh
+npx @owlmeans/agent-skills
+```

package/template/_gitignore

@@ -0,0 +1,7 @@
+node_modules
+build
+dist
+*.tsbuildinfo
+.DS_Store
+bun.lock
+bun.lockb

package/template/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "__APP_SLUG__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "packageManager": "bun@1.3.10",
+  "workspaces": [
+    "sources/*"
+  ],
+  "scripts": {
+    "dev": "bun run --filter './sources/*' --parallel dev",
+    "build": "bun run --filter './sources/*' build",
+    "typecheck": "bun run --filter './sources/*' typecheck"
+  },
+  "overrides": {
+    "react-router": "^7.*"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.11"
+  }
+}

package/template/sources/api/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "__APP_SLUG__-api",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "build/index.js",
+  "scripts": {
+    "dev": "sleep 3 && bun --watch --preserve-symlinks src/index.ts",
+    "start": "bun src/index.ts",
+    "build": "tsc -b",
+    "typecheck": "tsc -b"
+  },
+  "dependencies": {
+    "@owlmeans/server-app": "^0.1.9",
+    "@owlmeans/static-resource": "^0.1.9",
+    "__APP_SLUG__-common": "workspace:^"
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "^0.1.9",
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.2"
+  }
+}

package/template/sources/api/src/app/session/add.ts

@@ -0,0 +1,20 @@
+import { randomUUID } from 'node:crypto'
+import { handleBody } from '@owlmeans/server-app'
+import type { AddItemPayload, SessionItem, SessionParams } from '__APP_SLUG__-common'
+import { SESSION_ITEMS } from '../../consts.js'
+import type { Context } from '../../types.js'
+
+export const add = handleBody<AddItemPayload>(async (payload, context, req) => {
+  const ctx = context as Context
+  const { sid } = req.params as SessionParams
+  const resource = ctx.getStaticResource<SessionItem>(SESSION_ITEMS)
+
+  const item: SessionItem = {
+    id: randomUUID(),
+    sessionId: sid,
+    text: payload.text,
+    createdAt: new Date().toISOString(),
+  }
+
+  return await resource.create(item)
+})

package/template/sources/api/src/app/session/index.ts

@@ -0,0 +1,3 @@
+export { list } from './list.js'
+export { add } from './add.js'
+export { remove } from './remove.js'

package/template/sources/api/src/app/session/list.ts

@@ -0,0 +1,15 @@
+import { handleParams } from '@owlmeans/server-app'
+import type { SessionItem, SessionParams } from '__APP_SLUG__-common'
+import { SESSION_ITEMS } from '../../consts.js'
+import type { Context } from '../../types.js'
+
+export const list = handleParams<SessionParams>(async (params, context) => {
+  const ctx = context as Context
+  const resource = ctx.getStaticResource<SessionItem>(SESSION_ITEMS)
+
+  // The static resource lists every record; filter to this session and sort newest first.
+  const { items } = await resource.list<SessionItem>()
+  return items
+    .filter(item => item.sessionId === params.sid)
+    .sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1))
+})

package/template/sources/api/src/app/session/remove.ts

@@ -0,0 +1,18 @@
+import { handleParams } from '@owlmeans/server-app'
+import type { ItemParams, SessionItem } from '__APP_SLUG__-common'
+import { SESSION_ITEMS } from '../../consts.js'
+import type { Context } from '../../types.js'
+
+export const remove = handleParams<ItemParams>(async (params, context) => {
+  const ctx = context as Context
+  const resource = ctx.getStaticResource<SessionItem>(SESSION_ITEMS)
+
+  const existing = await resource.load<SessionItem>(params.id)
+  // Only remove the item if it belongs to the requesting session.
+  if (existing == null || existing.sessionId !== params.sid) {
+    return { removed: false }
+  }
+
+  await resource.delete(params.id)
+  return { removed: true }
+})

package/template/sources/api/src/config.ts

@@ -0,0 +1,8 @@
+import { config } from '@owlmeans/server-app'
+import { APP_API, commonConfig } from '__APP_SLUG__-common'
+import type { Config } from './types.js'
+
+// The server listens on the APP_API service route's port (3000), declared in common/config.ts.
+const cfg = config<Config>(APP_API, commonConfig as Config)
+
+export default cfg

package/template/sources/api/src/consts.ts

@@ -0,0 +1,2 @@
+/** Alias of the in-memory resource that holds session items. */
+export const SESSION_ITEMS = 'session-items'