create-crossbind 2.0.0-beta.50

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Buğra Sarı and crossbind contributors
+
+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,63 @@
+# create-crossbind
+**Create crossbind Applications**  
+
+<a href="https://www.npmjs.com/package/create-crossbind">
+    <img alt="NPM version" src="https://img.shields.io/npm/v/create-crossbind?style=for-the-badge" />
+</a>
+<a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
+    <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
+</a>
+<a href="https://crossbind.dev/docs/guide/getting-started/create-a-project">
+    <img alt="Docs - Create App" src="https://img.shields.io/badge/Docs_-_Create_App-20B2AA?style=for-the-badge" />
+</a>
+
+# Getting Started
+
+>**Note**: Make sure you have completed the [crossbind - Prerequisites](https://crossbind.dev/docs/guide/getting-started/prerequisites) instructions.
+
+```bash
+npm create crossbind@beta
+```
+
+This command will install and execute create-crossbind, the official crossbind project scaffolding tool. You will be presented with prompts for several optional features such as React.
+
+```
+Welcome to crossbind!
+
+✔ Project Name … <your-project-name>
+✔ Where should we create your project?
+  (leave blank to use current directory) … <your-project-name>
+✔ Select a type: › Web
+✔ Select a framework: › React
+✔ Select a bundler: › Vite
+
+Your project is ready!
+```
+
+If you are unsure about an option, simply choose Web, React and Vite. Once the project is created, follow the instructions to install dependencies and start the dev server:
+
+```bash
+cd <your-project-name>
+npm install
+npm run dev
+```
+
+You should now have your first crossbind project running!
+
+## Without the prompts
+
+Every prompt can be preselected positionally, which is what CI and scripted setups use.
+`npm create crossbind@beta -- --help` prints the list of templates.
+
+```bash
+npm create crossbind@beta -- my-app Web React Vite
+npm create crossbind@beta -- my-lib Library Prebuilt
+```
+
+When you are ready to ship your app to production, run the following:
+
+```bash
+npm run build
+```
+
+This will create a production-ready build of your app in the project's ./dist directory.

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "create-crossbind",
+  "version": "2.0.0-beta.50",
+  "description": "Create crossbind Applications",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/tooling/create-app#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crossbind/crossbind.git"
+  },
+  "license": "MIT",
+  "main": "src/index.js",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "src",
+    "templates"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.7.0"
+  },
+  "keywords": [
+    "crossbind",
+    "webassembly",
+    "react-native",
+    "expo",
+    "bind",
+    "c++",
+    "react",
+    "vue",
+    "svelte",
+    "webpack",
+    "vite",
+    "rspack",
+    "create-react-app",
+    "metro",
+    "android",
+    "ios"
+  ],
+  "scripts": {
+    "build-templates": "node scripts/build-templates.js"
+  },
+  "bin": {
+    "create-crossbind": "src/index.js"
+  }
+}

package/src/index.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { styleText } from 'node:util';
+import * as p from '@clack/prompts';
+import { pkgManager } from './utils.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = path.resolve(__dirname, '..');
+const TEMPLATES_DIR = path.join(PKG_ROOT, 'templates');
+const MANIFEST = JSON.parse(fs.readFileSync(path.join(__dirname, 'manifest.json'), 'utf8'));
+const { version } = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
+
+const exitOnCancel = (value) => {
+    if (p.isCancel(value)) {
+        p.cancel('Cancelled.');
+        process.exit(0);
+    }
+    return value;
+};
+
+const unique = (arr) => [...new Set(arr)];
+
+async function pickTemplate(presetGroup, presetFirst, presetSecond) {
+    const groups = unique(MANIFEST.map((m) => m.group));
+    const group = presetGroup || exitOnCancel(await p.select({
+        message: 'What kind of project?',
+        options: groups.map((g) => ({ value: g, label: g })),
+    }));
+    const inGroup = MANIFEST.filter((m) => m.group === group);
+
+    // "first" = framework if present, else label (Library/Cloud have no framework level).
+    const firstChoices = unique(inGroup.map((m) => m.framework ?? m.label));
+    let first = presetFirst;
+    if (!first) {
+        first = firstChoices.length === 1
+            ? firstChoices[0]
+            : exitOnCancel(await p.select({
+                message: 'Choose framework / variant',
+                options: firstChoices.map((c) => ({ value: c, label: c })),
+            }));
+    }
+    const inFirst = inGroup.filter((m) => (m.framework ?? m.label) === first);
+    if (inFirst.length === 1) return inFirst[0];
+
+    const second = presetSecond || exitOnCancel(await p.select({
+        message: 'Choose bundler / ecosystem',
+        options: inFirst.map((m) => ({ value: m.label, label: m.label })),
+    }));
+    const entry = inFirst.find((m) => m.label === second);
+    if (!entry) {
+        p.cancel(`Unknown template: ${group} / ${first} / ${second}`);
+        process.exit(1);
+    }
+    return entry;
+}
+
+async function ensureEmpty(dir) {
+    if (!fs.existsSync(dir) || fs.readdirSync(dir).length === 0) return;
+    const cont = exitOnCancel(await p.confirm({
+        message: `Directory not empty (${dir}). Continue?`,
+        initialValue: false,
+    }));
+    if (!cont) { p.cancel('Cancelled.'); process.exit(0); }
+}
+
+// Build the post-scaffold "Next steps" from the template's own scripts so we
+// never suggest a command the template doesn't define (e.g. `run dev` only
+// exists for some web/cloud templates; mobile needs platform-specific setup).
+function runSteps(entry, scripts, pm) {
+    const has = (script) => Boolean(scripts[script]);
+
+    if (entry.group === 'Mobile') {
+        const launch = `${pm} run ios   # or: ${pm} run android`;
+        if (entry.key === 'mobile-reactnative-expo') return ['npx expo prebuild', launch];
+        return ['cd ios && pod install && cd ..', launch];
+    }
+    if (entry.kind === 'lib') return [`${pm} run build`];
+    if (has('dev')) return [`${pm} run dev`];
+    if (has('start')) return [`${pm} start`];
+    if (has('preview')) return [`${pm} run build`, `${pm} run preview`];
+    if (has('build')) return [`${pm} run build`];
+    return [];
+}
+
+// Every prompt can be preselected positionally, so CI and docs can scaffold without a TTY.
+function usage() {
+    const rows = MANIFEST.map((m) => `  ${[m.group, m.framework ?? m.label, m.framework ? m.label : ''].filter(Boolean).join(' ')}`);
+    return [
+        `create-crossbind v${version}`,
+        '',
+        'Usage:',
+        '  npm create crossbind@beta                                                  interactive',
+        '  npm create crossbind@beta -- <dir> <group> <framework|variant> [<variant>]  preselected',
+        '',
+        'Examples:',
+        '  npm create crossbind@beta -- my-app Web Vanilla',
+        '  npm create crossbind@beta -- my-app Web React Vite',
+        '  npm create crossbind@beta -- my-lib Library Prebuilt',
+        '',
+        'Templates:',
+        ...rows,
+        '',
+    ].join('\n');
+}
+
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(usage());
+        process.exit(0);
+    }
+    const flag = args.find((a) => a.startsWith('-'));
+    if (flag) {
+        process.stderr.write(`create-crossbind: unknown option '${flag}' - arguments are positional.\n\n${usage()}`);
+        process.exit(1);
+    }
+
+    p.intro(styleText(['cyan', 'bold'], `create-crossbind v${version}`));
+
+    const [argName, argGroup, argFirst, argSecond] = args;
+
+    const name = argName || exitOnCancel(await p.text({
+        message: 'Project name',
+        placeholder: 'sample',
+        initialValue: 'sample',
+        validate: (v) => ((!v || v.trim().length === 0) ? 'Required' : undefined),
+    }));
+
+    const dirArg = argName || exitOnCancel(await p.text({
+        message: 'Where should we create your project?',
+        placeholder: name,
+        initialValue: name,
+        validate: (v) => ((!v || v.trim().length === 0) ? 'Required' : undefined),
+    }));
+    const cwd = path.resolve(process.cwd(), dirArg);
+
+    await ensureEmpty(cwd);
+
+    const entry = await pickTemplate(argGroup, argFirst, argSecond);
+    const src = path.join(TEMPLATES_DIR, entry.key);
+    if (!fs.existsSync(src)) {
+        p.cancel(`Template missing: ${entry.key} (expected ${src}). Did you publish with prepublishOnly?`);
+        process.exit(1);
+    }
+
+    const spin = p.spinner();
+    spin.start(`Scaffolding ${entry.key}`);
+    await fsp.mkdir(cwd, { recursive: true });
+    await fsp.cp(src, cwd, { recursive: true });
+
+    const pjPath = path.join(cwd, 'package.json');
+    let scripts = {};
+    if (fs.existsSync(pjPath)) {
+        const pkg = JSON.parse(await fsp.readFile(pjPath, 'utf8'));
+        pkg.name = entry.kind === 'lib' ? `crossbind-lib-${name}` : name;
+        await fsp.writeFile(pjPath, `${JSON.stringify(pkg, null, 2)}\n`);
+        scripts = pkg.scripts || {};
+    }
+
+    const gradlew = path.join(cwd, 'android', 'gradlew');
+    if (fs.existsSync(gradlew)) await fsp.chmod(gradlew, 0o755);
+
+    spin.stop(`Created ${path.relative(process.cwd(), cwd) || '.'}`);
+
+    const rel = path.relative(process.cwd(), cwd);
+    const steps = [
+        ...(rel ? [`cd ${rel}`] : []),
+        `${pkgManager} install`,
+        ...runSteps(entry, scripts, pkgManager),
+    ];
+
+    p.note(steps.map((s, i) => `${i + 1}. ${styleText('cyan', s)}`).join('\n'), 'Next steps');
+    p.outro(styleText('green', 'Done!'));
+}
+
+main().catch((err) => {
+    process.stderr.write(`create-crossbind failed: ${err.stack || err}\n`);
+    process.exit(1);
+});

package/src/manifest.json

@@ -0,0 +1,14 @@
+[
+  { "key": "web-vanilla",             "group": "Web",     "framework": null,           "label": "Vanilla",           "kind": "app", "source": "examples/web-vanilla" },
+  { "key": "web-react-rspack",        "group": "Web",     "framework": "React",        "label": "Rspack",            "kind": "app", "source": "examples/web-react-rspack" },
+  { "key": "web-react-vite",          "group": "Web",     "framework": "React",        "label": "Vite",              "kind": "app", "source": "examples/web-react-vite" },
+  { "key": "web-vue-vite",            "group": "Web",     "framework": "Vue",          "label": "Vite",              "kind": "app", "source": "examples/web-vue-vite" },
+  { "key": "web-svelte-vite",         "group": "Web",     "framework": "Svelte",       "label": "Vite",              "kind": "app", "source": "examples/web-svelte-vite" },
+  { "key": "mobile-reactnative-cli",  "group": "Mobile",  "framework": "React Native", "label": "Native CLI",        "kind": "app", "source": "examples/mobile-reactnative-cli", "nativeFolders": true },
+  { "key": "mobile-reactnative-expo", "group": "Mobile",  "framework": "React Native", "label": "Expo",              "kind": "app", "source": "examples/mobile-reactnative-expo", "nativeFolders": false, "keepLockfile": true },
+  { "key": "backend-nodejs-wasm",     "group": "Backend", "framework": "Node.js",      "label": "WebAssembly",       "kind": "app", "source": "examples/backend-nodejs-wasm" },
+  { "key": "cloud-cloudflare-worker", "group": "Cloud",   "framework": null,           "label": "Cloudflare Worker", "kind": "app", "source": "examples/cloud-cloudflare-worker" },
+  { "key": "lib-prebuilt",            "group": "Library", "framework": null,           "label": "Prebuilt",          "kind": "lib", "source": "examples/lib-prebuilt-matrix" },
+  { "key": "lib-source",              "group": "Library", "framework": null,           "label": "Source",            "kind": "lib", "source": "examples/lib-source" },
+  { "key": "lib-cmake",               "group": "Library", "framework": null,           "label": "CMake",             "kind": "lib", "source": "examples/lib-cmake" }
+]

package/src/utils.js

@@ -0,0 +1,8 @@
+function pkgFromUserAgent(userAgent) {
+    if (!userAgent) return {};
+    const [pkgSpec] = userAgent.split(' ');
+    const [name, version] = pkgSpec.split('/');
+    return { name, version };
+}
+
+export const pkgManager = pkgFromUserAgent(process.env.npm_config_user_agent).name || 'npm';

package/templates/backend-nodejs-wasm/CHANGELOG.md

@@ -0,0 +1,34 @@
+# @crossbind/example-backend-nodejs-wasm
+
+## 2.0.0-beta.50
+
+### Patch Changes
+
+- Aligned on the 2.0.0-beta.50 baseline. No source change; the version exists so every package in
+  the workspace names the same release.
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - crossbind@1.0.4
+
+## 1.0.0
+
+### Major Changes
+
+- 🚀 first stable release
+
+### Patch Changes
+
+- Updated dependencies
+  - @crossbind/example-lib-prebuilt-matrix@1.0.0
+
+## 1.0.0-beta.14
+
+### Patch Changes
+
+- chore: add initial version of CHANGELOGS files
+- Updated dependencies
+  - @crossbind/example-lib-prebuilt-matrix@1.0.0-beta.32

package/templates/backend-nodejs-wasm/README.md

@@ -0,0 +1,32 @@
+# @crossbind/example-backend-nodejs-wasm
+**crossbind Node.js webassembly sample**  
+
+<a href="https://www.npmjs.com/package/@crossbind/example-backend-nodejs-wasm">
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-backend-nodejs-wasm?style=for-the-badge" />
+</a>
+<a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
+    <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
+</a>
+<a href="https://crossbind.dev/docs/guide/integrate-into-existing-project/nodejs">
+    <img alt="Docs - Node.js" src="https://img.shields.io/badge/Docs_-_Node.js-20B2AA?style=for-the-badge" />
+</a>
+
+# Getting Started
+
+>**Note**: Make sure you have completed the [crossbind - Prerequisites](https://crossbind.dev/docs/guide/getting-started/prerequisites) instructions.
+
+## Setup
+
+Install the dependencies:
+
+```bash
+pnpm install
+```
+
+## Get Started
+
+Build native code to webassembly:
+
+```bash
+pnpm run build
+```

package/templates/backend-nodejs-wasm/crossbind.config.mjs

@@ -0,0 +1,14 @@
+import Matrix from '@crossbind/example-lib-prebuilt-matrix/crossbind.config.js';
+
+export default {
+    general: {
+        name: 'crossbind-example-backend-nodejs-wasm',
+    },
+    dependencies: [
+        Matrix,
+    ],
+    paths: {
+        config: import.meta.url,
+        output: 'dist',
+    },
+};

package/templates/backend-nodejs-wasm/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@crossbind/example-backend-nodejs-wasm",
+  "private": true,
+  "version": "0.0.0",
+  "description": "crossbind - Node.js webassembly sample",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/examples/backend-nodejs-wasm#readme",
+  "repository": "https://github.com/crossbind/crossbind.git",
+  "license": "MIT",
+  "scripts": {
+    "build": "crossbind build -p wasm -a wasm32 -r st -e node -b release"
+  },
+  "dependencies": {
+    "@crossbind/example-lib-prebuilt-matrix": "^2.0.0-beta.50"
+  },
+  "devDependencies": {
+    "crossbind": "^2.0.0-beta.51"
+  },
+  "keywords": [
+    "crossbind-sample",
+    "node",
+    "webassembly",
+    "bind",
+    "c++"
+  ]
+}

package/templates/backend-nodejs-wasm/src/index.js

@@ -0,0 +1,5 @@
+const initNative = require('../dist/crossbind-example-backend-nodejs-wasm-wasm-wasm32-st-release.node.js');
+
+initNative().then(({ Native }) => {
+    console.log(`Matrix multiplier with c++ => ${Native.sample()}`);
+});

package/templates/backend-nodejs-wasm/src/index.mjs

@@ -0,0 +1,5 @@
+import initNative from '../dist/crossbind-example-backend-nodejs-wasm-wasm-wasm32-st-release.node.js';
+
+initNative().then(({ Native }) => {
+    console.log(`Matrix multiplier with c++ => ${Native.sample()}`);
+});

package/templates/backend-nodejs-wasm/src/native/native.cpp

@@ -0,0 +1,9 @@
+#include "native.h"
+#include <Matrix.h>
+
+std::string Native::sample() {
+  auto firstMatrix = std::make_shared<Matrix>(9, 1);
+  auto secondMatrix = std::make_shared<Matrix>(9, 2);
+  auto resultStr = std::to_string(firstMatrix->multiple(secondMatrix)->get(0));
+  return "J₃ * (2*J₃) = " + resultStr + "*J₃";
+}

package/templates/backend-nodejs-wasm/src/native/native.h

@@ -0,0 +1,12 @@
+#ifndef _NATIVE_H
+#define _NATIVE_H
+
+#include <string>
+#include <memory>
+
+class Native {
+public:
+    static std::string sample();
+};
+
+#endif

package/templates/cloud-cloudflare-worker/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @crossbind/example-cloud-cloudflare-worker
+
+## 2.0.0-beta.50
+
+### Patch Changes
+
+- Aligned on the 2.0.0-beta.50 baseline. No source change; the version exists so every package in
+  the workspace names the same release.
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - crossbind@1.0.4
+
+## 1.0.0
+
+### Major Changes
+
+- 🚀 first stable release
+
+## 1.0.0-beta.12
+
+### Patch Changes
+
+- chore: add initial version of CHANGELOGS files

package/templates/cloud-cloudflare-worker/Readme.md

@@ -0,0 +1,46 @@
+# @crossbind/example-cloud-cloudflare-worker
+**crossbind Cloudflare Worker sample**  
+
+<a href="https://www.npmjs.com/package/@crossbind/example-cloud-cloudflare-worker">
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-cloud-cloudflare-worker?style=for-the-badge" />
+</a>
+<a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
+    <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
+</a>
+<a href="https://crossbind.dev/docs/guide/integrate-into-existing-project/cloudflare-worker">
+    <img alt="Docs - Cloudflare Worker" src="https://img.shields.io/badge/Docs_-_Cloudflare_Worker-20B2AA?style=for-the-badge" />
+</a>
+
+<https://crossbind.bugra9.workers.dev>
+
+# Getting Started
+
+>**Note**: Make sure you have completed the [crossbind - Prerequisites](https://crossbind.dev/docs/guide/getting-started/prerequisites) instructions.
+
+## Setup
+
+Install the dependencies:
+
+```bash
+pnpm install
+```
+
+## Get Started
+
+Build native code to webassembly:
+
+```bash
+pnpm run build
+```
+
+Start the dev server:
+
+```bash
+pnpm run dev
+```
+
+Deploy to the Cloudflare Workers:
+
+```bash
+pnpm run deploy
+```

package/templates/cloud-cloudflare-worker/crossbind.config.mjs

@@ -0,0 +1,9 @@
+export default {
+    general: {
+        name: 'crossbind-example-cloud-cloudflare-worker',
+    },
+    paths: {
+        config: import.meta.url,
+        output: 'dist',
+    },
+};

package/templates/cloud-cloudflare-worker/e2e/crossbind.spec.cjs

@@ -0,0 +1,7 @@
+// @ts-check
+const { test, expect } = require('@playwright/test');
+
+test('check string receiving from c++', async ({ page }) => {
+    await page.goto('/')
+    await expect(page.getByText('Hello World, greetings from c++.')).toBeVisible()
+});

package/templates/cloud-cloudflare-worker/index.js

@@ -0,0 +1,10 @@
+import initNative from './dist/crossbind-example-cloud-cloudflare-worker-wasm-wasm32-st-release.edge.js';
+import wasmContent from './dist/crossbind-example-cloud-cloudflare-worker-wasm-wasm32-st-release.edge.wasm';
+
+const { Native } = await initNative({ getWasmFunction: () => wasmContent });
+
+export default {
+    async fetch(request, env, ctx) {
+        return new Response(Native.sample());
+    },
+};

package/templates/cloud-cloudflare-worker/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@crossbind/example-cloud-cloudflare-worker",
+  "private": true,
+  "version": "0.0.0",
+  "description": "crossbind - Cloudflare webassembly sample",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/examples/cloud-cloudflare-worker#readme",
+  "repository": "https://github.com/crossbind/crossbind.git",
+  "license": "MIT",
+  "scripts": {
+    "build": "crossbind build -p wasm -a wasm32 -r st -e edge -b release",
+    "dev": "wrangler dev",
+    "deploy": "wrangler dev",
+    "e2e:dev": "playwright test --config playwright.dev.config.cjs",
+    "e2e:prod": "playwright test --config playwright.dev.config.cjs"
+  },
+  "files": [
+    "dist/@crossbind/example-cloud-cloudflare.edge.js",
+    "dist/@crossbind/example-cloud-cloudflare.edge.wasm",
+    "index.js",
+    "crossbind.config.mjs",
+    "wrangler.toml",
+    "src"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "crossbind": "^2.0.0-beta.51",
+    "wrangler": "^4.120.0",
+    "@playwright/test": "^1.62.1"
+  },
+  "keywords": [
+    "crossbind-sample",
+    "cloudflare",
+    "cloudflare-worker",
+    "webassembly",
+    "bind",
+    "c++"
+  ]
+}