create-vidra-app 0.1.0

package/dist/index.js

@@ -0,0 +1,241 @@
+// src/index.ts
+import prompts from "prompts";
+import chalk2 from "chalk";
+import fs2 from "fs-extra";
+import path2 from "path";
+import { randomUUID } from "crypto";
+import { fileURLToPath } from "url";
+
+// src/utils.ts
+var toPascalCase = (str) => {
+  return str.replace(
+    /[-_]+(.)?/g,
+    (_, c) => c ? c.toUpperCase() : ""
+  ).replace(/^(.)/, (_, c) => c.toUpperCase());
+};
+var toKebabCase = (str) => {
+  return str.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+};
+var toTitleCase = (str) => {
+  return str.replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+};
+var toTextPath = (p) => p.replaceAll("\\", "/");
+var parseArgs = (argv) => {
+  const args = { _: [] };
+  for (let i = 2; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      const [key, val] = arg.slice(2).split("=");
+      args[key] = val ?? argv[++i] ?? true;
+    } else {
+      args._.push(arg);
+    }
+  }
+  return args;
+};
+
+// src/exec.ts
+import { execSync } from "child_process";
+import chalk from "chalk";
+var exec = (cmd, cwd) => {
+  try {
+    execSync(cmd, { cwd, stdio: "pipe" });
+  } catch (e) {
+    const err = e;
+    console.error(chalk.red(`  Command failed: ${cmd}`));
+    console.error(chalk.dim(err.stderr?.toString() || err.message));
+    process.exit(1);
+  }
+};
+var tryExec = (cmd, cwd) => {
+  try {
+    execSync(cmd, { cwd, stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+// src/scaffold.ts
+import fs from "fs-extra";
+import path from "path";
+var TEMPLATE_FILE_RENAMES = {
+  _gitignore: ".gitignore"
+};
+var TEXT_EXTS = /* @__PURE__ */ new Set([
+  ".cs",
+  ".csproj",
+  ".xaml",
+  ".sln",
+  ".json",
+  ".xml",
+  ".ts",
+  ".tsx",
+  ".js",
+  ".mjs",
+  ".jsx",
+  ".css",
+  ".html",
+  ".md",
+  ".plist",
+  ".targets",
+  ".props",
+  ".txt",
+  ".Config",
+  ""
+]);
+var scaffoldDir = async (srcDir, destDir, replacements) => {
+  const entries = await fs.readdir(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(srcDir, entry.name);
+    const destName = TEMPLATE_FILE_RENAMES[entry.name] ?? applyReplacements(entry.name, replacements);
+    const destPath = path.join(destDir, destName);
+    if (entry.isDirectory()) {
+      await fs.ensureDir(destPath);
+      await scaffoldDir(srcPath, destPath, replacements);
+    } else {
+      const ext = path.extname(entry.name);
+      if (TEXT_EXTS.has(ext)) {
+        let content = await fs.readFile(srcPath, "utf8");
+        content = applyReplacements(content, replacements);
+        await fs.outputFile(destPath, content);
+      } else {
+        await fs.copy(srcPath, destPath);
+      }
+    }
+  }
+};
+var applyReplacements = (str, replacements) => {
+  for (const [key, val] of Object.entries(replacements)) {
+    str = str.replaceAll(key, val);
+  }
+  return str;
+};
+
+// src/index.ts
+var __dirname = path2.dirname(fileURLToPath(import.meta.url));
+var CLI_ROOT = path2.resolve(__dirname, "..");
+var TEMPLATES_DIR = path2.join(CLI_ROOT, "templates");
+var VIDRA_REPO_ROOT = path2.resolve(CLI_ROOT, "..", "..", "..");
+var LOCAL_FEED_DIR = path2.join(VIDRA_REPO_ROOT, "dist", "packages");
+var LOCAL_CLI_DIR = CLI_ROOT;
+var LOCAL_SDK_DIR = path2.join(VIDRA_REPO_ROOT, "src", "sdk", "vidra-js");
+var VIDRA_VERSION = "0.1.0";
+var SDK_VERSION = "0.1.0";
+var main = async () => {
+  console.log();
+  console.log(chalk2.bold("  create-vidra-app"));
+  console.log(chalk2.dim("  Scaffold a new Vidra application\n"));
+  const args = parseArgs(process.argv);
+  let projectDir = args._[0];
+  let appId = args["app-id"];
+  if (!projectDir) {
+    const res = await prompts(
+      {
+        type: "text",
+        name: "projectDir",
+        message: "Project name:",
+        initial: "my-vidra-app",
+        validate: (v) => /^[a-zA-Z][\w-]*$/.test(v) || "Must start with a letter, alphanumeric/hyphens only"
+      },
+      { onCancel: () => process.exit(1) }
+    );
+    projectDir = res.projectDir;
+  }
+  const projectName = toPascalCase(projectDir);
+  const projectNameKebab = toKebabCase(projectDir);
+  const appTitle = toTitleCase(projectDir);
+  const appGuid = randomUUID().toUpperCase();
+  if (!appId) {
+    const res = await prompts(
+      {
+        type: "text",
+        name: "appId",
+        message: "App ID (reverse domain):",
+        initial: `com.vidra.${projectNameKebab.replace(/-/g, "")}`,
+        validate: (v) => /^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)+$/.test(v) || "Must be reverse-domain (e.g. com.company.app)"
+      },
+      { onCancel: () => process.exit(1) }
+    );
+    appId = res.appId;
+  }
+  const root = path2.resolve(projectDir);
+  if (fs2.existsSync(root) && fs2.readdirSync(root).length > 0) {
+    console.error(
+      chalk2.red(
+        `
+  Directory "${projectDir}" already exists and is not empty.
+`
+      )
+    );
+    process.exit(1);
+  }
+  console.log();
+  console.log(`  ${chalk2.dim("Project:")}    ${chalk2.cyan(projectName)}`);
+  console.log(`  ${chalk2.dim("Directory:")}  ${chalk2.cyan(root)}`);
+  console.log(`  ${chalk2.dim("App ID:")}     ${chalk2.cyan(appId)}`);
+  console.log();
+  const isMonorepo = fs2.existsSync(path2.join(LOCAL_SDK_DIR, "package.json"));
+  const localFeedExists = isMonorepo && fs2.existsSync(LOCAL_FEED_DIR);
+  const localFeedPath = localFeedExists ? toTextPath(LOCAL_FEED_DIR) : "";
+  const cliRef = isMonorepo ? `file:${toTextPath(LOCAL_CLI_DIR)}` : `^${VIDRA_VERSION}`;
+  const sdkRef = isMonorepo ? `file:${toTextPath(LOCAL_SDK_DIR)}` : `^${SDK_VERSION}`;
+  const replacements = {
+    "{{projectName}}": projectName,
+    "{{projectNameKebab}}": projectNameKebab,
+    "{{appId}}": appId,
+    "{{appGuid}}": appGuid,
+    "{{appTitle}}": appTitle,
+    "{{cliVersion}}": cliRef,
+    "{{vidraVersion}}": VIDRA_VERSION,
+    "{{sdkVersion}}": sdkRef,
+    "{{localFeedPath}}": localFeedPath
+  };
+  const templateDir = path2.join(TEMPLATES_DIR, "react-vite");
+  await scaffoldDir(templateDir, root, replacements);
+  console.log(chalk2.dim("  Creating solution..."));
+  exec(`dotnet new sln -n ${projectName} --force`, root);
+  const slnFile = fs2.existsSync(path2.join(root, `${projectName}.slnx`)) ? `${projectName}.slnx` : `${projectName}.sln`;
+  exec(
+    `dotnet sln ${slnFile} add src/${projectName}.Host/${projectName}.Host.csproj`,
+    root
+  );
+  const uiDir = path2.join(root, "ui");
+  console.log(chalk2.dim("  Installing npm dependencies..."));
+  const npmOk = tryExec("npm install", uiDir);
+  console.log();
+  console.log(chalk2.green("  Done! ") + "Your Vidra app is ready.\n");
+  if (localFeedExists) {
+    console.log(
+      chalk2.dim("  NuGet:") + " local feed \u2192 " + chalk2.cyan(LOCAL_FEED_DIR)
+    );
+  } else if (isMonorepo) {
+    console.log(
+      chalk2.yellow("  Note: ") + "Local NuGet feed not found. Run " + chalk2.cyan("./pack-local.sh") + " in the Vidra repo, then update NuGet.Config."
+    );
+  }
+  if (isMonorepo) {
+    console.log(
+      chalk2.dim("  npm:  ") + " @vidra-dev/sdk \u2192 " + chalk2.cyan(LOCAL_SDK_DIR)
+    );
+    console.log(
+      chalk2.dim("  npm:  ") + " create-vidra-app \u2192 " + chalk2.cyan(LOCAL_CLI_DIR)
+    );
+  }
+  console.log();
+  if (!npmOk) {
+    console.log(
+      chalk2.yellow("  Note: ") + "`npm install` had errors. Run " + chalk2.cyan("cd ui && npm install") + " to retry.\n"
+    );
+  }
+  console.log(chalk2.bold("  Next steps:\n"));
+  console.log(`    cd ${projectDir}`);
+  console.log(
+    `    npm run dev  ${chalk2.dim("# starts Vite + MAUI host together")}`
+  );
+  console.log();
+};
+main().catch((e) => {
+  console.error(chalk2.red(e.message));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "create-vidra-app",
+  "version": "0.1.0",
+  "description": "Scaffold a new Vidra application (React + .NET MAUI)",
+  "type": "module",
+  "bin": {
+    "create-vidra-app": "./bin/create-vidra-app.mjs",
+    "vidra": "./bin/vidra.mjs"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "vidra",
+    "maui",
+    "react",
+    "cross-platform",
+    "scaffold",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rzamfiriu/vidra.git",
+    "directory": "src/cli/create-vidra-app"
+  },
+  "homepage": "https://github.com/rzamfiriu/vidra#readme",
+  "bugs": {
+    "url": "https://github.com/rzamfiriu/vidra/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "fs-extra": "^11.2.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.9.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^2.1.4"
+  }
+}

package/templates/react-vite/NuGet.Config

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
+    <add key="vidra-local" value="{{localFeedPath}}" />
+  </packageSources>
+</configuration>

package/templates/react-vite/README.md

@@ -0,0 +1,57 @@
+# {{appTitle}}
+
+A cross-platform application built with [Vidra](https://github.com/user/vidra) — React UI + .NET MAUI native host.
+
+## Getting Started
+
+### Prerequisites
+
+- [.NET 10 SDK](https://dotnet.microsoft.com/download) with MAUI workload
+- [Node.js](https://nodejs.org/) 18+
+- Windows development must be run from a Windows machine with the MAUI Windows workload installed
+
+### Development
+
+```bash
+npm run dev
+```
+
+This starts the Vite dev server and launches the native host for the current OS.
+
+To target a specific desktop platform explicitly:
+
+```bash
+vidra dev --target macos
+vidra dev --target windows
+```
+
+If you want to run the pieces separately:
+
+```bash
+npm run dev:ui
+npm run dev:host:macos
+npm run dev:host:windows
+```
+
+### Production Build
+
+```bash
+npm run build
+```
+
+## Project Structure
+
+```
+{{projectNameKebab}}/
+├── src/
+│   └── {{projectName}}.Host/     # .NET MAUI native host
+│       ├── MauiProgram.cs         # App configuration + Vidra setup
+│       ├── MainPage.cs            # Main page (extends VidraPage)
+│       └── Platforms/             # Platform-specific code
+└── ui/                            # React frontend
+    ├── src/
+    │   ├── App.tsx                # Main React component
+    │   └── main.tsx               # Entry point
+    ├── vite.config.ts
+    └── package.json
+```

package/templates/react-vite/_gitignore

@@ -0,0 +1,16 @@
+# Build artifacts
+dist/
+src/*/Resources/Raw/wwwroot/
+*.tsbuildinfo
+
+# .NET
+**/bin/
+**/obj/
+
+# Node
+node_modules/
+
+# IDE
+.vs/
+.vscode/
+*.user

package/templates/react-vite/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "{{projectNameKebab}}",
+  "private": true,
+  "scripts": {
+    "build": "vidra build",
+    "dev": "vidra dev",
+    "dev:ui": "npm run dev --prefix ui",
+    "dev:host:macos": "dotnet build -t:Run -f net10.0-maccatalyst src/{{projectName}}.Host/{{projectName}}.Host.csproj",
+    "dev:host:windows": "dotnet build -t:Run -f net10.0-windows10.0.19041.0 src/{{projectName}}.Host/{{projectName}}.Host.csproj"
+  },
+  "devDependencies": {
+    "create-vidra-app": "{{cliVersion}}"
+  }
+}

package/templates/react-vite/src/{{projectName}}.Host/App.xaml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             x:Class="{{projectName}}.App">
+</Application>

package/templates/react-vite/src/{{projectName}}.Host/App.xaml.cs

@@ -0,0 +1,14 @@
+namespace {{projectName}};
+
+public partial class App : Application
+{
+    public App()
+    {
+        InitializeComponent();
+    }
+
+    protected override Window CreateWindow(IActivationState? activationState)
+    {
+        return new Window(new MainPage());
+    }
+}

package/templates/react-vite/src/{{projectName}}.Host/MainPage.cs

@@ -0,0 +1,28 @@
+using Vidra.Hosting;
+
+namespace {{projectName}};
+
+public class MainPage : VidraPage
+{
+    public MainPage()
+    {
+        StartCounterTimer();
+    }
+
+    private async void StartCounterTimer()
+    {
+        using var timer = new PeriodicTimer(TimeSpan.FromSeconds(10));
+        while (await timer.WaitForNextTickAsync())
+        {
+            try
+            {
+                var count = await Bridge.CallJsAsync<int>("counter.increment");
+                System.Diagnostics.Debug.WriteLine($"[MainPage] Counter is now {count}");
+            }
+            catch (Exception ex)
+            {
+                System.Diagnostics.Debug.WriteLine($"[MainPage] Counter increment failed: {ex.Message}");
+            }
+        }
+    }
+}

package/templates/react-vite/src/{{projectName}}.Host/MauiProgram.cs

@@ -0,0 +1,26 @@
+using Microsoft.Extensions.Logging;
+using Vidra.Hosting;
+
+namespace {{projectName}};
+
+public static class MauiProgram
+{
+    public static MauiApp CreateMauiApp()
+    {
+        var builder = MauiApp.CreateBuilder();
+
+        builder
+            .UseMauiApp<App>()
+            .UseVidra()
+            .ConfigureFonts(fonts =>
+            {
+                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
+            });
+
+#if DEBUG
+        builder.Logging.AddDebug();
+#endif
+
+        return builder.Build();
+    }
+}

package/templates/react-vite/src/{{projectName}}.Host/Platforms/MacCatalyst/AppDelegate.cs

@@ -0,0 +1,9 @@
+using Foundation;
+
+namespace {{projectName}};
+
+[Register("AppDelegate")]
+public class AppDelegate : MauiUIApplicationDelegate
+{
+    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+}

package/templates/react-vite/src/{{projectName}}.Host/Platforms/MacCatalyst/Info.plist

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>NSAppTransportSecurity</key>
+	<dict>
+		<key>NSAllowsLocalNetworking</key>
+		<true/>
+	</dict>
+</dict>
+</plist>

package/templates/react-vite/src/{{projectName}}.Host/Platforms/MacCatalyst/Program.cs

@@ -0,0 +1,11 @@
+using UIKit;
+
+namespace {{projectName}};
+
+public static class Program
+{
+    static void Main(string[] args)
+    {
+        UIApplication.Main(args, null, typeof(AppDelegate));
+    }
+}

package/templates/react-vite/src/{{projectName}}.Host/Platforms/Windows/App.xaml

@@ -0,0 +1,8 @@
+<!-- Needed for WinUI -->
+<maui:MauiWinUIApplication
+    x:Class="{{projectName}}.WinUI.App"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:maui="using:Microsoft.Maui"
+    xmlns:local="using:{{projectName}}.WinUI">
+</maui:MauiWinUIApplication>

package/templates/react-vite/src/{{projectName}}.Host/Platforms/Windows/App.xaml.cs

@@ -0,0 +1,11 @@
+namespace {{projectName}}.WinUI;
+
+public partial class App : MauiWinUIApplication
+{
+    public App()
+    {
+        this.InitializeComponent();
+    }
+
+    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+}

package/templates/react-vite/src/{{projectName}}.Host/{{projectName}}.Host.csproj

@@ -0,0 +1,57 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('osx'))">net10.0-maccatalyst</TargetFrameworks>
+    <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">net10.0-windows10.0.19041.0</TargetFrameworks>
+    <ValidateXcodeVersion>false</ValidateXcodeVersion>
+    <OutputType>Exe</OutputType>
+    <RootNamespace>{{projectName}}</RootNamespace>
+    <UseMaui>true</UseMaui>
+    <SingleProject>true</SingleProject>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <LangVersion>latest</LangVersion>
+
+    <ApplicationTitle>{{appTitle}}</ApplicationTitle>
+    <ApplicationIdGuid>{{appGuid}}</ApplicationIdGuid>
+    <ApplicationId>{{appId}}</ApplicationId>
+    <ApplicationVersion>1</ApplicationVersion>
+    <ApplicationDisplayVersion>0.1.0</ApplicationDisplayVersion>
+    <EnableCodeSigning Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">true</EnableCodeSigning>
+
+    <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">15.0</SupportedOSPlatformVersion>
+    <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">10.0.17763.0</SupportedOSPlatformVersion>
+
+    <!--
+      Build as an unpackaged Win32-style app on Windows. The scaffolded
+      template intentionally ships without a Platforms/Windows/Package.appxmanifest;
+      MSIX packaging is the consumer's responsibility (e.g. via the `vidra
+      build` CLI) and would otherwise fail a plain `dotnet build` with NETSDK
+      errors from the WindowsAppSDK MSIX targets.
+    -->
+    <WindowsPackageType Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">None</WindowsPackageType>
+
+    <!--
+      Skip the MacCatalyst managed linker in Debug. The linker's Setup step
+      validates the MacCatalyst SDK headers against the maui workload version,
+      and the maui workload tracks the newest Xcode aggressively (MT0180).
+      Disabling the linker for Debug builds gives consistent compile semantics
+      regardless of the local Xcode, and matches the fast-iteration default
+      that Hot Restart-style flows use. Release builds (e.g. `vidra build
+      target macos`) keep the default linker so production trimming is
+      preserved.
+    -->
+    <MtouchLink Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst' And '$(Configuration)' == 'Debug'">None</MtouchLink>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <MauiAsset Include="Resources\Raw\**" LogicalName="%(RecursiveDir)%(Filename)%(Extension)" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Maui.Controls" Version="$(MauiVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="9.0.0" />
+    <PackageReference Include="Vidra.Hosting.Maui" Version="{{vidraVersion}}" />
+  </ItemGroup>
+
+</Project>

package/templates/react-vite/ui/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{appTitle}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react-vite/ui/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{projectNameKebab}}",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@vidra-dev/sdk": "{{sdkVersion}}",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.4.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  }
+}