create-vidra-app 0.4.0 → 0.5.1

package/README.md

@@ -1,53 +1,46 @@
 # create-vidra-app
 
-Scaffold a new [Vidra](https://vidra.build) application — a
-**React UI + .NET MAUI native host**, shipped from a single codebase.
+Scaffold a [Vidra](https://vidra.build) desktop app with a web UI and a
+C#/.NET native host.
 
-> **Alpha.** APIs and templates may change between 0.x releases.
+> **Alpha:** APIs and templates may change between 0.x releases.
 
-## Usage
+## Create an app
 
 ```bash
 npm create vidra-app@latest
 # or
 npx create-vidra-app my-app
-```
-
-You'll be prompted for a project name and an app ID (reverse-domain). Then:
 
-```bash
 cd my-app
-npm run dev   # starts Vite + the native host together
+npm run dev
 ```
 
-Scaffolded apps get the `vidra` CLI as a local dev dependency — there's no
-global `vidra` to install. Run it from inside your project via the npm scripts
-or `npx`:
+The generated project depends on [`vidra-cli`](https://www.npmjs.com/package/vidra-cli),
+which provides the `vidra` command. This package is only needed to create the
+app; nothing depends on it afterwards. Use the provided npm scripts or run
+`vidra` through `npx`; no global install is required.
 
-```bash
-npm run dev                     # start Vite + native host
-npm run build                   # build + package for distribution
-npm run doctor                  # check your .NET / MAUI / Xcode setup
-npx vidra dev --target windows  # run a specific desktop target
-npx vidra build --target macos  # build + package a macOS .dmg
-```
-
-## Prerequisites
+## Requirements
 
 - .NET 10 SDK
-- The .NET MAUI workload: `dotnet workload install maui`
-- Node.js 18+
-- macOS targets require Xcode; Windows targets must be built on Windows
+- .NET MAUI workload: `dotnet workload install maui`
+- Node.js 22 or newer
+- Xcode for macOS builds
+
+Windows targets must be built on Windows.
 
-If the MAUI workload is missing, `create-vidra-app` will detect it after
-scaffolding and offer to install it for you. You can re-check at any time with
-`npm run doctor`. 
+## Common commands
 
-## Links
+```bash
+npm run dev
+npm run build
+npm run doctor
+npx vidra --help
+```
 
-- Website: [vidra.build](https://vidra.build)
-- GitHub: [rzamfiriu/vidra](https://github.com/rzamfiriu/vidra)
-- npm: [create-vidra-app](https://www.npmjs.com/package/create-vidra-app)
+See the [getting started guide](https://vidra.build/docs/getting-started/) for
+project structure, development, and build options.
 
 ## License
 

package/dist/index.js

@@ -1,11 +1,11 @@
 // src/index.ts
 import prompts2 from "prompts";
-import fs9 from "fs-extra";
-import path10 from "path";
+import fs2 from "fs-extra";
+import path2 from "path";
 import { randomUUID } from "crypto";
 import { fileURLToPath } from "url";
 
-// src/utils.ts
+// ../shared/src/utils.ts
 var toPascalCase = (str) => {
   return str.replace(
     /[-_]+(.)?/g,
@@ -42,11 +42,13 @@ var parseArgs = (argv) => {
   }
   return args;
 };
+var splitLines = (text) => text.split(/\r?\n/);
+var isInteractive = () => Boolean(process.stdin.isTTY && process.stdout.isTTY);
 
-// src/exec.ts
-import { execSync, spawn } from "child_process";
+// ../shared/src/exec.ts
+import { execFileSync, execSync, spawn } from "child_process";
 
-// src/theme.ts
+// ../shared/src/theme.ts
 import chalk from "chalk";
 var lime = chalk.hex("#c8f751");
 var value = chalk.hex("#e8e8ec");
@@ -88,11 +90,28 @@ var row = (opts) => {
 var footer = (content) => `  ${content}`;
 var fixLine = (cmd, label = "fix:") => `      ${amber(label)} ${lime(cmd)}`;
 
-// src/exec.ts
+// ../shared/src/exec.ts
 var toText = (value2) => {
   if (value2 == null) return "";
   return Buffer.isBuffer(value2) ? value2.toString() : value2;
 };
+var run = (cmd, args) => {
+  try {
+    const stdout = execFileSync(cmd, args, {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    return { found: true, ok: true, stdout: stdout ?? "", stderr: "" };
+  } catch (e) {
+    const err = e;
+    return {
+      found: err.code !== "ENOENT",
+      ok: false,
+      stdout: toText(err.stdout),
+      stderr: toText(err.stderr)
+    };
+  }
+};
 var formatProcessError = (error) => {
   const err = error;
   const combined = [toText(err.stderr), toText(err.stdout)].map((s) => s.trim()).filter((s) => s.length > 0).join("\n").trim();
@@ -169,69 +188,12 @@ var applyReplacements = (str, replacements) => {
   return str;
 };
 
-// src/doctor.ts
-import { execFileSync as execFileSync5 } from "child_process";
-import fs8 from "fs";
-import path9 from "path";
-import prompts from "prompts";
-
-// src/signing.ts
-import path2 from "path";
-import fs2 from "fs-extra";
-import { execFileSync, spawnSync } from "child_process";
-
-// src/notarize.ts
-import path3 from "path";
+// ../shared/src/dotnet-toolchain.ts
 import { execFileSync as execFileSync2 } from "child_process";
-
-// src/windows-signing.ts
-import path4 from "path";
-import fs3 from "fs-extra";
-import { execFileSync as execFileSync3 } from "child_process";
-
-// src/velopack.ts
-import path5 from "path";
-import os from "os";
-import fs4 from "fs-extra";
-import { execFileSync as execFileSync4 } from "child_process";
-
-// src/update-config.ts
-import path6 from "path";
-import fs5 from "fs-extra";
-
-// src/project.ts
-import path8 from "path";
-
-// src/version.ts
-import fs6 from "fs-extra";
-import path7 from "path";
-
-// src/project.ts
-import fs7 from "fs-extra";
-
-// src/doctor.ts
+import prompts from "prompts";
 var DOTNET = process.platform === "win32" ? "dotnet.exe" : "dotnet";
 var MAUI_DOCS = "https://learn.microsoft.com/dotnet/maui/get-started/installation";
 var INSTALL_NET_10_FIX = "Install the .NET 10 SDK \u2014 https://dotnet.microsoft.com/download";
-var bufToStr = (v) => v == null ? "" : Buffer.isBuffer(v) ? v.toString() : v;
-var run = (cmd, args) => {
-  try {
-    const stdout = execFileSync5(cmd, args, {
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    return { found: true, ok: true, stdout: stdout ?? "", stderr: "" };
-  } catch (e) {
-    const err = e;
-    return {
-      found: err.code !== "ENOENT",
-      ok: false,
-      stdout: bufToStr(err.stdout),
-      stderr: bufToStr(err.stderr)
-    };
-  }
-};
-var splitLines = (text) => text.split(/\r?\n/);
 var NET_10_VERSION = /^10\./;
 var MAUI_WORKLOAD = /\bmaui\b/i;
 var hasNet10Sdk = (listSdksOutput) => splitLines(listSdksOutput).some((line) => NET_10_VERSION.test(line.trim()));
@@ -265,7 +227,6 @@ var checkDotnetSdk = () => {
   };
 };
 var isMauiWorkloadInstalled = () => outputMentionsMaui(run(DOTNET, ["workload", "list"]).stdout);
-var isInteractive = () => Boolean(process.stdin.isTTY && process.stdout.isTTY);
 var installWorkload = (csprojPath) => {
   const args = csprojPath ? ["workload", "restore", csprojPath] : ["workload", "install", "maui"];
   console.log();
@@ -282,7 +243,7 @@ var installWorkload = (csprojPath) => {
   );
   console.log();
   try {
-    execFileSync5(DOTNET, args, { stdio: "inherit" });
+    execFileSync2(DOTNET, args, { stdio: "inherit" });
     return true;
   } catch {
     console.error();
@@ -360,15 +321,15 @@ var ensureMauiWorkload = async (opts = {}) => {
 
 // src/index.ts
 var note = (label, body) => `  ${dim(label.padEnd(7))} ${body}`;
-var __dirname = path10.dirname(fileURLToPath(import.meta.url));
-var CLI_ROOT = path10.resolve(__dirname, "..");
-var TEMPLATES_DIR = path10.join(CLI_ROOT, "templates");
-var VIDRA_REPO_ROOT = path10.resolve(CLI_ROOT, "..", "..", "..");
-var LOCAL_FEED_DIR = path10.join(VIDRA_REPO_ROOT, "dist", "packages");
-var LOCAL_CLI_DIR = CLI_ROOT;
-var LOCAL_SDK_DIR = path10.join(VIDRA_REPO_ROOT, "src", "sdk", "vidra-js");
+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 = path2.join(VIDRA_REPO_ROOT, "src", "cli", "vidra-cli");
+var LOCAL_SDK_DIR = path2.join(VIDRA_REPO_ROOT, "src", "sdk", "vidra-js");
 var VIDRA_VERSION = JSON.parse(
-  fs9.readFileSync(path10.join(CLI_ROOT, "package.json"), "utf-8")
+  fs2.readFileSync(path2.join(CLI_ROOT, "package.json"), "utf-8")
 ).version;
 var SDK_VERSION = VIDRA_VERSION;
 var main = async () => {
@@ -409,8 +370,8 @@ var main = async () => {
     );
     appId = res.appId;
   }
-  const root = path10.resolve(projectDir);
-  if (fs9.existsSync(root) && fs9.readdirSync(root).length > 0) {
+  const root = path2.resolve(projectDir);
+  if (fs2.existsSync(root) && fs2.readdirSync(root).length > 0) {
     console.error();
     console.error(
       row({
@@ -426,8 +387,8 @@ var main = async () => {
   console.log(kv("directory", root));
   console.log(kv("app id", appId));
   console.log();
-  const isMonorepo = fs9.existsSync(path10.join(LOCAL_SDK_DIR, "package.json"));
-  const localFeedExists = isMonorepo && fs9.existsSync(LOCAL_FEED_DIR);
+  const isMonorepo = fs2.existsSync(path2.join(LOCAL_SDK_DIR, "package.json"));
+  const localFeedExists = isMonorepo && fs2.existsSync(LOCAL_FEED_DIR);
   const localFeedSource = localFeedExists ? `    <add key="vidra-local" value="${toTextPath(LOCAL_FEED_DIR)}" />` : "";
   const cliRef = isMonorepo ? `file:${toTextPath(LOCAL_CLI_DIR)}` : `^${VIDRA_VERSION}`;
   const sdkRef = isMonorepo ? `file:${toTextPath(LOCAL_SDK_DIR)}` : `^${SDK_VERSION}`;
@@ -442,17 +403,17 @@ var main = async () => {
     "{{sdkVersion}}": sdkRef,
     "{{localFeedSource}}": localFeedSource
   };
-  const templateDir = path10.join(TEMPLATES_DIR, "react-vite");
+  const templateDir = path2.join(TEMPLATES_DIR, "react-vite");
   await scaffoldDir(templateDir, root, replacements);
   console.log(row({ glyph: "active", detail: dim("creating solution\u2026") }));
   exec(`dotnet new sln -n ${projectName} --force`, root);
-  const slnFile = fs9.existsSync(path10.join(root, `${projectName}.slnx`)) ? `${projectName}.slnx` : `${projectName}.sln`;
+  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
   );
   console.log(row({ glyph: "active", detail: dim("installing dependencies\u2026") }));
-  const uiDir = path10.join(root, "ui");
+  const uiDir = path2.join(root, "ui");
   const [rootNpmOk, uiNpmOk] = await Promise.all([
     tryExecAsync("npm install", root),
     tryExecAsync("npm install", uiDir)
@@ -478,7 +439,7 @@ var main = async () => {
   }
   if (isMonorepo) {
     console.log(note("npm", `${dim("@vidra-dev/sdk \u2192")} ${value(LOCAL_SDK_DIR)}`));
-    console.log(note("npm", `${dim("create-vidra-app \u2192")} ${value(LOCAL_CLI_DIR)}`));
+    console.log(note("npm", `${dim("vidra-cli \u2192")} ${value(LOCAL_CLI_DIR)}`));
   }
   console.log();
   if (!npmOk) {
@@ -490,7 +451,7 @@ var main = async () => {
     );
     console.log();
   }
-  const hostCsproj = path10.join(
+  const hostCsproj = path2.join(
     root,
     "src",
     `${projectName}.Host`,

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "create-vidra-app",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Scaffold a new Vidra application (React + .NET MAUI)",
   "type": "module",
   "bin": {
-    "create-vidra-app": "./bin/create-vidra-app.mjs",
-    "vidra": "./bin/vidra.mjs"
+    "create-vidra-app": "bin/create-vidra-app.mjs"
   },
   "files": [
     "bin/",
@@ -15,6 +14,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "npm run build"
@@ -33,8 +33,7 @@
     "desktop",
     "electron-alternative",
     "tauri-alternative",
-    "scaffold",
-    "cli"
+    "scaffold"
   ],
   "repository": {
     "type": "git",
@@ -47,19 +46,23 @@
   },
   "license": "MIT",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
-    "chalk": "^5.4.1",
+    "chalk": "^6.0.0",
     "fs-extra": "^11.2.0",
     "prompts": "^2.4.2"
   },
   "devDependencies": {
+    "@vidra-dev/cli-shared": "*",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.9.0",
+    "@types/node": "^22.20.0",
     "@types/prompts": "^2.4.9",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.2",
-    "vitest": "^2.1.4"
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
   }
 }

package/templates/react-vite/README.md

@@ -1,97 +1,45 @@
 # {{appTitle}}
 
-A cross-platform application built with [Vidra](https://vidra.build) — React UI + .NET MAUI native host.
+A desktop application built with [Vidra](https://vidra.build): a React UI and a
+C#/.NET native host.
 
-## Getting Started
-
-### Prerequisites
+## Requirements
 
 - [.NET 10 SDK](https://dotnet.microsoft.com/download)
-- The .NET MAUI workload: `dotnet workload install maui`
-- [Node.js](https://nodejs.org/) 18+
-- macOS targets require Xcode; Windows targets must be built on Windows
-
-Not sure if you're set up? Run:
-
-```bash
-npm run doctor
-```
+- .NET MAUI workload: `dotnet workload install maui`
+- [Node.js](https://nodejs.org/) 22 or newer
+- Xcode for macOS builds
 
-It checks your .NET SDK, the MAUI workload, and (on macOS) Xcode, and prints the
-exact command to fix anything that's missing.
+Windows targets must be built on Windows.
 
-> The `vidra` CLI ships as a local dev dependency of this project, so run it
-> through npm (`npm run dev`, `npm run doctor`) or with `npx vidra <command>` —
-> there is no global `vidra` command to install.
-
-### Development
+## Development
 
 ```bash
+npm run doctor
 npm run dev
 ```
 
-This starts the Vite dev server and launches the native host for the current OS
-under `dotnet watch`. Both sides of the app pick up your edits:
-
-- **UI**: edit anything in `ui/src` — Vite HMR updates the WebView instantly.
-- **C#**: edit the host (for example `OnTickAsync` in `MainPage.cs`) and save —
-  the session puts the change in front of you in seconds. *How* depends on the
-  platform:
-  - **Windows**: supported edits apply to the *running* app and the UI flashes a
-    "C# reloaded" badge. Edits hot reload can't express (new fields, changed
-    signatures, …) trigger an automatic rebuild and relaunch.
-  - **macOS**: the same, when the toolchain cooperates. Mac Catalyst's
-    hot-reload agent often drops its connection mid-session (dotnet/sdk#55488);
-    a dropped agent applies nothing while `dotnet watch` still reports success,
-    so `vidra dev` watches for it and switches the session to rebuild +
-    relaunch on save. You'll see it say so — after that, edits arrive with a
-    restart and no badge.
-    `npm run doctor` says which loop you get.
-
-To skip `dotnet watch` entirely and do a single build and launch:
-
-```bash
-npx vidra dev --no-hot-reload
-```
-
-To target a specific desktop platform explicitly:
-
-```bash
-npx vidra dev --target macos
-npx vidra dev --target windows
-```
-
-If you want to run the pieces separately:
+`npm run dev` starts Vite and the native host together. Changes to the web UI
+reload through Vite; supported C# changes reload through the .NET development
+loop.
 
-```bash
-npm run dev:ui
-npm run dev:host:macos
-npm run dev:host:windows
-```
-
-### Production Build
+## Build
 
 ```bash
 npm run build
 ```
 
-## Project Structure
+The `vidra` CLI is a local project dependency. Run `npx vidra --help` to see
+target, packaging, and update options.
 
-```
+## Project structure
+
+```text
 {{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
+│   └── {{projectName}}.Host/  # .NET MAUI host and C# contracts
+└── ui/                        # React application and generated TypeScript
 ```
 
----
-
-Built with [Vidra](https://vidra.build) — a C#/.NET native core with a web UI.
+Read the [Vidra documentation](https://vidra.build/docs/) for bridge guides,
+capabilities, distribution, and updates.

package/templates/react-vite/_gitignore

@@ -1,6 +1,8 @@
 # Build artifacts
 dist/
 src/*/Resources/Raw/wwwroot/
+src/*/Resources/Raw/vidra-bridge-policy.json
+ui/src/generated/vidra-access-policy.ts
 *.tsbuildinfo
 
 # .NET

package/templates/react-vite/package.json

@@ -11,6 +11,7 @@
     "doctor": "vidra doctor"
   },
   "devDependencies": {
-    "create-vidra-app": "{{cliVersion}}"
+    "@vidra-dev/sdk": "{{sdkVersion}}",
+    "vidra-cli": "{{cliVersion}}"
   }
 }

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

@@ -23,11 +23,22 @@ public class MainPage : VidraPage
         try
         {
             var count = await Bridge.Js().Counter.IncrementAsync();
-            System.Diagnostics.Debug.WriteLine($"[MainPage] Counter is now {count}");
+            Console.WriteLine($"[MainPage] Counter is now {count}");
         }
         catch (Exception ex)
         {
-            System.Diagnostics.Debug.WriteLine($"[MainPage] Counter increment failed: {ex.Message}");
+            // Console, which is what Vidra.Hosting itself logs through, and the
+            // only one of the three that a Release build actually emits.
+            // Debug.WriteLine is compiled out of Release entirely, and Release is
+            // exactly the build where someone is looking at a counter stuck at
+            // zero. Trace.TraceError survives the compile but goes to
+            // DefaultTraceListener, which writes nothing unless a debugger is
+            // attached, and this template registers no listener.
+            //
+            // The whole exception, not ex.Message: the bridge's answer to "why"
+            // is the error code on it, and JS_HANDLER_NOT_FOUND, JS_HANDLER_ERROR
+            // and JS_RESPONSE_INVALID are three different problems.
+            Console.Error.WriteLine($"[MainPage] Counter increment failed: {ex}");
         }
     }
 }

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

@@ -9,28 +9,32 @@ public static class MauiProgram
     {
         var builder = MauiApp.CreateBuilder();
 
-        // Updates come in two tiers. Both are opt-in and both read one
-        // `vidra.updates` block in package.json.
+        // Updates are wired up and doing nothing, which is the intended state
+        // until this app has a feed to check. The switch is already in
+        // vidra.config.ts, empty — filling it in is the whole opt-in:
         //
-        // Web bundle: fast, no reinstall. Add `.UseVidraUpdates()` below and
+        //   updates: { feed: "https://updates.example.com/notes/" }
         //
-        //   "vidra": { "updates": { "feedUrl": "https://example.com/bundles.json" } }
+        // Type a URL there, or run `npx vidra updates init --feed <url>`, then
+        // publish with `npx vidra build` (both tiers) or `npx vidra build --web`
+        // (just the UI, no compile).
         //
-        // then publish with `npx vidra bundle`. A bundle only installs when its
-        // contract fingerprints match this build, so JS can never call a bridge
-        // the installed binary lacks.
+        // One directory serves both tiers. To split them across two hosts:
         //
-        // Whole app: native code included. Reference Vidra.Updates.Native, add
-        // `.UseVidraNativeUpdates()`, uncomment the line in Platforms/*/Program.cs,
-        // and add
+        //   "feed": { "web": "https://cdn/notes/", "app": "https://dl/notes/" }
         //
-        //   "vidra": { "updates": { "native": { "feedUrl": "https://example.com/app/" } } }
+        // Web bundle: your `ui/` build, applied on the next launch, no reinstall.
+        // A bundle only installs when its contract fingerprints match this build,
+        // so JS can never call a bridge the installed binary lacks.
         //
-        // then build with `npx vidra build --target <target> --native-update`.
-        // `npx vidra doctor` names whichever half is missing.
+        // Whole app: native code included, via Velopack. Its other half is the
+        // `VelopackApp` line in Platforms/*/Program.cs, which has to run before
+        // the UI framework starts.
         builder
             .UseMauiApp<App>()
             .UseVidra()
+            .UseVidraUpdates()
+            .UseVidraNativeUpdates()
             .ConfigureFonts(fonts =>
             {
                 fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");

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

@@ -6,20 +6,17 @@
 // also inspects the assembly statically and warns when
 // `VelopackApp.Build()...Run()` is anywhere other than the entry point.
 //
+// It is live from the first scaffold and does nothing at all until this app is
+// installed from a Velopack release — which it is not, until `vidra.config.ts`
+// names an updates feed and `vidra build` packs
+// a release into it. Filling in that URL is the whole opt-in.
+//
 // `UseVidraLocator()` is the Mac Catalyst part. Velopack's client picks its
 // locator from `RuntimeInformation.IsOSPlatform`, which answers false for OSX
 // here, so without it, `Run()` throws before any update logic executes.
-//
-// To turn native updates on:
-//   1. add the Vidra.Updates.Native package reference to this project
-//   2. uncomment the two lines below, and the ones in MauiProgram.cs
-//   3. add a `vidra.updates.native.feedUrl` to package.json
-//   4. build with `npx vidra build --target macos --native-update`
-//
-// `npx vidra doctor` checks all four and names whichever is missing.
 
-// using Velopack;
-// using Vidra.Hosting;
+using Velopack;
+using Vidra.Hosting;
 using UIKit;
 
 namespace {{projectName}};
@@ -28,7 +25,7 @@ public static class Program
 {
     static void Main(string[] args)
     {
-        // VelopackApp.Build().UseVidraLocator().Run();
+        VelopackApp.Build().UseVidraLocator().Run();
 
         UIApplication.Main(args, null, typeof(AppDelegate));
     }

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

@@ -9,19 +9,15 @@
 // `--veloapp-*` argument and expects it to do that work and exit without ever
 // showing a window. `VelopackApp.Build()...Run()` is what handles those launches,
 // and `vpk pack` statically inspects the assembly and warns when it finds the
-// call anywhere other than the entry point. Putting it here costs nothing and
-// means an app that later enables updates needs no migration into generated code.
+// call anywhere other than the entry point.
 //
-// To turn native updates on:
-//   1. add the Vidra.Updates.Native package reference to this project
-//   2. uncomment the two lines below, and the ones in MauiProgram.cs
-//   3. add a `vidra.updates.native.feedUrl` to package.json
-//   4. build with `npx vidra build --target windows --native-update`
-//
-// `npx vidra doctor` checks all four and names whichever is missing.
+// It is live from the first scaffold and does nothing at all until this app is
+// installed from a Velopack release — which it is not, until `vidra.config.ts`
+// names an updates feed and `vidra build` packs
+// a release into it. Filling in that URL is the whole opt-in.
 
-// using Velopack;
-// using Vidra.Hosting;
+using Velopack;
+using Vidra.Hosting;
 
 namespace {{projectName}}.WinUI;
 
@@ -30,7 +26,7 @@ public static class Program
     [STAThread]
     static void Main(string[] args)
     {
-        // VelopackApp.Build().UseVidraLocator().Run();
+        VelopackApp.Build().UseVidraLocator().Run();
 
         WinRT.ComWrappersSupport.InitializeComWrappers();