electrobun 0.0.19-beta.70 → 0.0.19-beta.72

package/debug.js

@@ -0,0 +1,5 @@
+console.log('process.argv:', process.argv);
+const indexOfElectrobun = process.argv.findIndex((arg) => arg.includes('electrobun'));
+console.log('indexOfElectrobun:', indexOfElectrobun);
+const commandArg = process.argv[indexOfElectrobun + 1] || 'build';
+console.log('commandArg:', commandArg);

package/dist/api/bun/core/Updater.ts

@@ -1,10 +1,26 @@
 import { join, dirname, resolve } from "path";
-import { homedir, platform } from "os";
+import { homedir } from "os";
 import { renameSync, unlinkSync, mkdirSync, rmdirSync, statSync } from "fs";
 import tar from "tar";
 import { ZstdInit } from "@oneidentity/zstd-js/wasm";
-
-const appSupportDir = join(homedir(), "Library", "Application Support");
+import { OS as currentOS, ARCH as currentArch } from '../../shared/platform';
+
+// Cross-platform app data directory
+function getAppDataDir(): string {
+  switch (currentOS) {
+    case 'macos':
+      return join(homedir(), "Library", "Application Support");
+    case 'win':
+      // Use APPDATA environment variable or fallback to default location
+      return process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+    case 'linux':
+      // Use XDG_CONFIG_HOME or fallback to ~/.config
+      return process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+    default:
+      // Fallback to home directory with .config
+      return join(homedir(), ".config");
+  }
+}
 
 // todo (yoav): share type with cli
 let localInfo: {
@@ -46,7 +62,8 @@ const Updater = {
 
     const channelBucketUrl = await Updater.channelBucketUrl();
     const cacheBuster = Math.random().toString(36).substring(7);
-    const updateInfoUrl = join(channelBucketUrl, `update.json?${cacheBuster}`);
+    const platformFolder = `${localInfo.channel}-${currentOS}-${currentArch}`;
+    const updateInfoUrl = join(localInfo.bucketUrl, platformFolder, `update.json?${cacheBuster}`);
 
     try {
       const updateInfoResponse = await fetch(updateInfoUrl);
@@ -113,8 +130,9 @@ const Updater = {
         }
 
         // check if there's a patch file for it
+        const platformFolder = `${localInfo.channel}-${currentOS}-${currentArch}`;
         const patchResponse = await fetch(
-          join(channelBucketUrl, `${currentHash}.patch`)
+          join(localInfo.bucketUrl, platformFolder, `${currentHash}.patch`)
         );
 
         if (!patchResponse.ok) {
@@ -210,9 +228,21 @@ const Updater = {
       // then just download it and unpack it
       if (currentHash !== latestHash) {
         const cacheBuster = Math.random().toString(36).substring(7);
+        const platformFolder = `${localInfo.channel}-${currentOS}-${currentArch}`;
+        // Platform-specific tarball naming
+        let tarballName: string;
+        if (currentOS === 'macos') {
+          tarballName = `${appFileName}.app.tar.zst`;
+        } else if (currentOS === 'win') {
+          tarballName = `${appFileName}.tar.zst`;
+        } else {
+          tarballName = `${appFileName}.tar.zst`;
+        }
+        
         const urlToLatestTarball = join(
-          channelBucketUrl,
-          `${appFileName}.app.tar.zst`
+          localInfo.bucketUrl,
+          platformFolder,
+          tarballName
         );
         const prevVersionCompressedTarballPath = join(
           appDataFolder,
@@ -289,16 +319,24 @@ const Updater = {
           file: latestTarPath,
           cwd: extractionFolder,
           onentry: (entry) => {
-            // find the first .app bundle in the tarball
-            // Some apps may have nested .app bundles
-            if (!appBundleSubpath && entry.path.endsWith(".app/")) {
-              appBundleSubpath = entry.path;
+            if (currentOS === 'macos') {
+              // find the first .app bundle in the tarball
+              // Some apps may have nested .app bundles
+              if (!appBundleSubpath && entry.path.endsWith(".app/")) {
+                appBundleSubpath = entry.path;
+              }
+            } else {
+              // For Windows/Linux, look for the main executable
+              // This assumes the tarball contains the app at the root
+              if (!appBundleSubpath) {
+                appBundleSubpath = "./";
+              }
             }
           },
         });
 
         if (!appBundleSubpath) {
-          console.error("Failed to find app bundle in tarball");
+          console.error("Failed to find app in tarball");
           return;
         }
 
@@ -306,14 +344,22 @@ const Updater = {
         const newAppBundlePath = resolve(
           join(extractionFolder, appBundleSubpath)
         );
-        // Note: dirname(process.execPath) is the path to the running app bundle's
-        // Contents/MacOS directory
-        const runningAppBundlePath = resolve(
-          dirname(process.execPath),
-          "..",
-          ".."
-        );
-        const backupAppBundlePath = join(extractionFolder, "backup.app");
+        // Platform-specific app path calculation
+        let runningAppBundlePath: string;
+        if (currentOS === 'macos') {
+          // On macOS, executable is at Contents/MacOS/binary inside .app bundle
+          runningAppBundlePath = resolve(
+            dirname(process.execPath),
+            "..",
+            ".."
+          );
+        } else {
+          // On Windows/Linux, the executable is the app itself
+          runningAppBundlePath = process.execPath;
+        }
+        // Platform-specific backup naming
+        const backupName = currentOS === 'macos' ? "backup.app" : "backup";
+        const backupAppBundlePath = join(extractionFolder, backupName);
 
         try {
           // const backupState = statSync(backupAppBundlePath);
@@ -329,7 +375,20 @@ const Updater = {
           return;
         }
 
-        await Bun.spawn(["open", runningAppBundlePath]);
+        // Cross-platform app launch
+        switch (currentOS) {
+          case 'macos':
+            await Bun.spawn(["open", runningAppBundlePath]);
+            break;
+          case 'win':
+            // On Windows, the runningAppBundlePath would be the .exe file
+            await Bun.spawn([runningAppBundlePath]);
+            break;
+          case 'linux':
+            // On Linux, directly execute the binary
+            await Bun.spawn([runningAppBundlePath]);
+            break;
+        }
         process.exit(0);
       }
     }
@@ -337,14 +396,14 @@ const Updater = {
 
   channelBucketUrl: async () => {
     await Updater.getLocallocalInfo();
-    // todo: tmp hardcode canary
-    return join(localInfo.bucketUrl, localInfo.channel);
+    const platformFolder = `${localInfo.channel}-${currentOS}-${currentArch}`;
+    return join(localInfo.bucketUrl, platformFolder);
   },
 
   appDataFolder: async () => {
     await Updater.getLocallocalInfo();
     const appDataFolder = join(
-      appSupportDir,
+      getAppDataDir(),
       localInfo.identifier,
       localInfo.name
     );

package/dist/api/shared/platform.ts

@@ -0,0 +1,48 @@
+import { platform, arch } from 'os';
+
+export type SupportedOS = 'macos' | 'win' | 'linux';
+export type SupportedArch = 'arm64' | 'x64';
+
+// Cache platform() result to avoid multiple system calls
+const platformName = platform();
+const archName = arch();
+
+// Determine OS once
+export const OS: SupportedOS = (() => {
+  switch (platformName) {
+    case "win32":
+      return 'win';
+    case "darwin":
+      return 'macos';
+    case 'linux':
+      return 'linux';
+    default:
+      throw new Error(`Unsupported platform: ${platformName}`);
+  }
+})();
+
+// Determine ARCH once, with Windows override
+export const ARCH: SupportedArch = (() => {
+  // Always use x64 for Windows since we only build x64 Windows binaries
+  if (OS === 'win') {
+    return 'x64';
+  }
+  
+  switch (archName) {
+    case "arm64":
+      return 'arm64';
+    case "x64":
+      return 'x64';
+    default:
+      throw new Error(`Unsupported architecture: ${archName}`);
+  }
+})();
+
+// Export functions for backwards compatibility if needed
+export function getPlatformOS(): SupportedOS {
+  return OS;
+}
+
+export function getPlatformArch(): SupportedArch {
+  return ARCH;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electrobun",
-  "version": "0.0.19-beta.70",
+  "version": "0.0.19-beta.72",
   "description": "Build ultra fast, tiny, and cross-platform desktop apps with Typescript.",
   "license": "MIT",
   "author": "Blackboard Technologies Inc.",

package/src/cli/index.ts

@@ -2,6 +2,7 @@ import { join, dirname, basename } from "path";
 import {
   existsSync,
   readFileSync,
+  writeFileSync,
   cpSync,
   rmdirSync,
   mkdirSync,
@@ -12,40 +13,12 @@ import {
 import { execSync } from "child_process";
 import tar from "tar";
 import { ZstdInit } from "@oneidentity/zstd-js/wasm";
-import {platform, arch} from 'os';
+import { OS, ARCH } from '../shared/platform';
+import { getTemplate, getTemplateNames } from './templates/embedded';
 // import { loadBsdiff, loadBspatch } from 'bsdiff-wasm';
 // MacOS named pipes hang at around 4KB
 const MAX_CHUNK_SIZE = 1024 * 2;
 
-// TODO: dedup with built.ts
-const OS: 'win' | 'linux' | 'macos' = getPlatform();
-// Always use x64 for Windows since we only build x64 Windows binaries
-const ARCH: 'arm64' | 'x64' = OS === 'win' ? 'x64' : getArch();
-
-function getPlatform() {
-  switch (platform()) {
-      case "win32":
-          return 'win';
-      case "darwin":
-          return 'macos';
-      case 'linux':
-          return 'linux';
-      default:
-          throw 'unsupported platform';
-  }
-}
-
-function getArch() {
-  switch (arch()) {
-      case "arm64":
-          return 'arm64';
-      case "x64":
-          return 'x64';
-      default:
-          throw 'unsupported arch'
-  }
-}
-
 
 const binExt = OS === 'win' ? '.exe' : '';
 
@@ -711,8 +684,57 @@ const bundleFileName = targetOS === 'macos' ? `${appFileName}.app` : appFileName
 let proc = null;
 
 if (commandArg === "init") {
-  // todo (yoav): init a repo folder structure
-  console.log("initializing electrobun project");
+  const projectName = process.argv[indexOfElectrobun + 2] || "my-electrobun-app";
+  const templateName = process.argv.find(arg => arg.startsWith("--template="))?.split("=")[1] || "hello-world";
+  
+  console.log(`🚀 Initializing Electrobun project: ${projectName}`);
+  
+  // Validate template name
+  const availableTemplates = getTemplateNames();
+  if (!availableTemplates.includes(templateName)) {
+    console.error(`❌ Template "${templateName}" not found.`);
+    console.log(`Available templates: ${availableTemplates.join(", ")}`);
+    process.exit(1);
+  }
+  
+  const template = getTemplate(templateName);
+  if (!template) {
+    console.error(`❌ Could not load template "${templateName}"`);
+    process.exit(1);
+  }
+  
+  // Create project directory
+  const projectPath = join(process.cwd(), projectName);
+  if (existsSync(projectPath)) {
+    console.error(`❌ Directory "${projectName}" already exists.`);
+    process.exit(1);
+  }
+  
+  mkdirSync(projectPath, { recursive: true });
+  
+  // Extract template files
+  let fileCount = 0;
+  for (const [relativePath, content] of Object.entries(template.files)) {
+    const fullPath = join(projectPath, relativePath);
+    const dir = dirname(fullPath);
+    
+    // Create directory if it doesn't exist
+    mkdirSync(dir, { recursive: true });
+    
+    // Write file
+    writeFileSync(fullPath, content, 'utf-8');
+    fileCount++;
+  }
+  
+  console.log(`✅ Created ${fileCount} files from "${templateName}" template`);
+  console.log(`📁 Project created at: ${projectPath}`);
+  console.log("");
+  console.log("📦 Next steps:");
+  console.log(`   cd ${projectName}`);
+  console.log("   bun install");
+  console.log("   bunx electrobun dev");
+  console.log("");
+  console.log("🎉 Happy building with Electrobun!");
 } else if (commandArg === "build") {
   // Ensure core binaries are available for the target platform before starting build
   await ensureCoreDependencies(currentTarget.os, currentTarget.arch);
@@ -1306,7 +1328,7 @@ if (commandArg === "init") {
     // 6.5. code sign and notarize the dmg
     // 7. copy artifacts to directory [self-extractor dmg, zstd app bundle, bsdiff patch, update.json]
 
-    // Add platform suffix for all artifacts
+    // Platform suffix is only used for folder names, not file names
     const platformSuffix = `-${targetOS}-${targetARCH}`;
     const tarPath = `${appBundleFolderPath}.tar`;
 
@@ -1331,8 +1353,7 @@ if (commandArg === "init") {
     // than saving 1 more MB of space/bandwidth.
 
     const compressedTarPath = `${tarPath}.zst`;
-    const platformCompressedTarPath = compressedTarPath.replace('.tar.zst', `${platformSuffix}.tar.zst`);
-    artifactsToUpload.push(platformCompressedTarPath);
+    artifactsToUpload.push(compressedTarPath);
 
     // zstd compress tarball
     // todo (yoav): consider using c bindings for zstd for speed instead of wasm
@@ -1361,8 +1382,6 @@ if (commandArg === "init") {
         );
 
         await Bun.write(compressedTarPath, compressedData);
-        // Copy to platform-specific filename for upload
-        cpSync(compressedTarPath, platformCompressedTarPath);
       }
     });
 
@@ -1416,8 +1435,7 @@ if (commandArg === "init") {
       console.log("creating dmg...");
       // make a dmg
       const dmgPath = join(buildFolder, `${appFileName}.dmg`);
-      const platformDmgPath = join(buildFolder, `${appFileName}${platformSuffix}.dmg`);
-      artifactsToUpload.push(platformDmgPath);
+      artifactsToUpload.push(dmgPath);
       // hdiutil create -volname "YourAppName" -srcfolder /path/to/YourApp.app -ov -format UDZO YourAppName.dmg
       // Note: use ULFO (lzfse) for better compatibility with large CEF frameworks and modern macOS
       execSync(
@@ -1437,9 +1455,6 @@ if (commandArg === "init") {
       } else {
         console.log("skipping notarization");
       }
-      
-      // Copy to platform-specific filename
-      cpSync(dmgPath, platformDmgPath);
     } else {
       // For Windows and Linux, add the self-extracting bundle directly
       const platformBundlePath = join(buildFolder, `${appFileName}${platformSuffix}${targetOS === 'win' ? '.exe' : ''}`);
@@ -1447,10 +1462,10 @@ if (commandArg === "init") {
       if (targetOS === 'win') {
         // On Windows, create a self-extracting exe
         // For now, just copy the bundle folder
-        artifactsToUpload.push(compressedTarPath.replace('.tar.zst', `${platformSuffix}.tar.zst`));
+        artifactsToUpload.push(compressedTarPath);
       } else if (targetOS === 'linux') {
         // On Linux, create a tar.gz of the bundle
-        const linuxTarPath = join(buildFolder, `${appFileName}${platformSuffix}.tar.gz`);
+        const linuxTarPath = join(buildFolder, `${appFileName}.tar.gz`);
         execSync(`tar -czf ${escapePathForTerminal(linuxTarPath)} -C ${escapePathForTerminal(buildFolder)} ${escapePathForTerminal(basename(appBundleFolderPath))}`);
         artifactsToUpload.push(linuxTarPath);
       }
@@ -1478,9 +1493,8 @@ if (commandArg === "init") {
       // bucketUrl: config.release.bucketUrl
     });
 
-    // Platform-specific update.json
-    const platformUpdateJsonName = `update${platformSuffix}.json`;
-    await Bun.write(join(artifactFolder, platformUpdateJsonName), updateJsonContent);
+    // update.json (no platform suffix in filename, platform is in folder name)
+    await Bun.write(join(artifactFolder, 'update.json'), updateJsonContent);
 
     // generate bsdiff
     // https://storage.googleapis.com/eggbun-static/electrobun-playground/canary/ElectrobunPlayground-canary.app.tar.zst
@@ -1495,8 +1509,8 @@ if (commandArg === "init") {
     } else {
       const urlToPrevUpdateJson = join(
         config.release.bucketUrl,
-        buildEnvironment,
-        `update${platformSuffix}.json`
+        buildSubFolder,
+        'update.json'
       );
       const cacheBuster = Math.random().toString(36).substring(7);
       const updateJsonResponse = await fetch(
@@ -1507,8 +1521,8 @@ if (commandArg === "init") {
 
     const urlToLatestTarball = join(
       config.release.bucketUrl,
-      buildEnvironment,
-      `${appFileName}.app${platformSuffix}.tar.zst`
+      buildSubFolder,
+      `${appFileName}.app.tar.zst`
     );
 
 
@@ -1555,8 +1569,7 @@ if (commandArg === "init") {
         // especially for creating multiple diffs in parallel
         const bsdiffpath = targetPaths.BSDIFF;
         const patchFilePath = join(buildFolder, `${prevHash}.patch`);
-        const platformPatchFilePath = join(buildFolder, `${prevHash}${platformSuffix}.patch`);
-        artifactsToUpload.push(platformPatchFilePath);
+        artifactsToUpload.push(patchFilePath);
         const result = Bun.spawnSync(
           [bsdiffpath, prevTarballPath, tarPath, patchFilePath, "--use-zstd"],
           { cwd: buildFolder }
@@ -1566,8 +1579,6 @@ if (commandArg === "init") {
           result.stdout.toString(),
           result.stderr.toString()
         );
-        // Copy to platform-specific filename
-        cpSync(patchFilePath, platformPatchFilePath);
       }
     } else {
       console.log("prevoius version not found at: ", urlToLatestTarball);

package/templates/hello-world/README.md

@@ -0,0 +1,57 @@
+# Electrobun Hello World
+
+A simple Electrobun app to get you started with the framework.
+
+## What You'll See
+
+This hello world app demonstrates:
+- **Native Window**: A cross-platform desktop window
+- **Web-based UI**: Modern HTML, CSS, and JavaScript interface
+- **Simple Architecture**: Clean separation between Bun process and UI
+
+## Getting Started
+
+1. Install dependencies:
+   ```bash
+   bun install
+   ```
+
+2. Run in development mode:
+   ```bash
+   bun run dev
+   ```
+
+3. Build for production:
+   ```bash
+   bun run build
+   ```
+
+## Project Structure
+
+```
+src/
+├── bun/
+│   └── index.ts      # Main process - creates and manages windows
+└── mainview/
+    ├── index.html    # Your app's UI
+    ├── index.css     # Styles
+    └── index.ts      # View logic
+```
+
+## Next Steps
+
+Ready to build something more complex? Check out:
+
+- **[Documentation](https://docs.electrobun.dev)** - Learn about all Electrobun features
+- **[Examples](https://github.com/blackboardsh/electrobun/tree/main/playground)** - See advanced features like RPC, menus, and system tray
+- **[GitHub](https://github.com/blackboardsh/electrobun)** - Star the repo and join the community
+
+### Add More Features
+
+Want to extend this app? Try adding:
+- RPC communication between Bun and webview
+- Native menus and system tray
+- File dialogs and system integration
+- Multiple windows and views
+
+Happy building! 🚀

package/templates/hello-world/bun.lock

@@ -0,0 +1,63 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "electrobun-hello-world",
+      "dependencies": {
+        "electrobun": "latest",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+    },
+  },
+  "packages": {
+    "@oneidentity/zstd-js": ["@oneidentity/zstd-js@1.0.3", "", { "dependencies": { "@types/emscripten": "^1.39.4" } }, "sha512-Jm6sawqxLzBrjC4sg2BeXToa33yPzUmq20CKsehKY2++D/gHb/oSwVjNgT+RH4vys+r8FynrgcNzGwhZWMLzfQ=="],
+
+    "@types/bun": ["@types/bun@1.2.19", "", { "dependencies": { "bun-types": "1.2.19" } }, "sha512-d9ZCmrH3CJ2uYKXQIUuZ/pUnTqIvLDS0SK7pFmbx8ma+ziH/FRMoAq5bYpRG7y+w1gl+HgyNZbtqgMq4W4e2Lg=="],
+
+    "@types/emscripten": ["@types/emscripten@1.40.1", "", {}, "sha512-sr53lnYkQNhjHNN0oJDdUm5564biioI5DuOpycufDVK7D3y+GR3oUswe2rlwY1nPNyusHbrJ9WoTyIHl4/Bpwg=="],
+
+    "@types/filesystem": ["@types/filesystem@0.0.36", "", { "dependencies": { "@types/filewriter": "*" } }, "sha512-vPDXOZuannb9FZdxgHnqSwAG/jvdGM8Wq+6N4D/d80z+D4HWH+bItqsZaVRQykAn6WEVeEkLm2oQigyHtgb0RA=="],
+
+    "@types/filewriter": ["@types/filewriter@0.0.33", "", {}, "sha512-xFU8ZXTw4gd358lb2jw25nxY9QAgqn2+bKKjKOYfNCzN4DKCFetK7sPtrlpg66Ywe3vWY9FNxprZawAh9wfJ3g=="],
+
+    "@types/har-format": ["@types/har-format@1.2.16", "", {}, "sha512-fluxdy7ryD3MV6h8pTfTYpy/xQzCFC7m89nOH9y94cNqJ1mDIDPut7MnRHI3F6qRmh/cT2fUjG1MLdCNb4hE9A=="],
+
+    "@types/node": ["@types/node@24.1.0", "", { "dependencies": { "undici-types": "~7.8.0" } }, "sha512-ut5FthK5moxFKH2T1CUOC6ctR67rQRvvHdFLCD2Ql6KXmMuCrjsSsRI9UsLCm9M18BMwClv4pn327UvB7eeO1w=="],
+
+    "@types/react": ["@types/react@19.1.9", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-WmdoynAX8Stew/36uTSVMcLJJ1KRh6L3IZRx1PZ7qJtBqT3dYTgyDTx8H1qoRghErydW7xw9mSJ3wS//tCRpFA=="],
+
+    "@types/webextension-polyfill": ["@types/webextension-polyfill@0.12.3", "", {}, "sha512-F58aDVSeN/MjUGazXo/cPsmR76EvqQhQ1v4x23hFjUX0cfAJYE+JBWwiOGW36/VJGGxoH74sVlRIF3z7SJCKyg=="],
+
+    "browser-namespace": ["browser-namespace@1.4.0", "", { "dependencies": { "@types/filesystem": "*", "@types/har-format": "*", "@types/webextension-polyfill": "*" } }, "sha512-9b4yNTNs+8HVPssSq8RSZMRunf+G4cVQ2PMtOTn+uEVFOW5C0Uo+eGXuJ5LfxS1UDph5oAdWj92thPyxVhpqXg=="],
+
+    "bun-types": ["bun-types@1.2.19", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-uAOTaZSPuYsWIXRpj7o56Let0g/wjihKCkeRqUBhlLVM/Bt+Fj9xTo+LhC1OV1XDaGkz4hNC80et5xgy+9KTHQ=="],
+
+    "chownr": ["chownr@2.0.0", "", {}, "sha512-bIomtDF5KGpdogkLd9VspvFzk9KfpyyGlS8YFVZl7TGPBHL5snIOnxeshwVgPteQ9b4Eydl+pVbIyE1DcvCWgQ=="],
+
+    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
+
+    "electrobun": ["electrobun@0.0.18", "", { "dependencies": { "@oneidentity/zstd-js": "^1.0.3", "rpc-anywhere": "1.5.0", "tar": "^6.2.1" }, "bin": { "electrobun": "dist/electrobun" } }, "sha512-RyMNGcAaHklicZlJToGfN3fVZGKHpxZv6o8S96TK9tHSY/SRze5bNPIGUnY9wr/BbWuQW5gGUGaVIWWqa5NSZQ=="],
+
+    "fs-minipass": ["fs-minipass@2.1.0", "", { "dependencies": { "minipass": "^3.0.0" } }, "sha512-V/JgOLFCS+R6Vcq0slCuaeWEdNC3ouDlJMNIsacH2VtALiu9mV4LPrHc5cDl8k5aw6J8jwgWWpiTo5RYhmIzvg=="],
+
+    "minipass": ["minipass@5.0.0", "", {}, "sha512-3FnjYuehv9k6ovOEbyOswadCDPX1piCfhV8ncmYtHOjuPwylVWsghTLo7rabjC3Rx5xD4HDx8Wm1xnMF7S5qFQ=="],
+
+    "minizlib": ["minizlib@2.1.2", "", { "dependencies": { "minipass": "^3.0.0", "yallist": "^4.0.0" } }, "sha512-bAxsR8BVfj60DWXHE3u30oHzfl4G7khkSuPW+qvpd7jFRHm7dLxOjUk1EHACJ/hxLY8phGJ0YhYHZo7jil7Qdg=="],
+
+    "mkdirp": ["mkdirp@1.0.4", "", { "bin": { "mkdirp": "bin/cmd.js" } }, "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw=="],
+
+    "rpc-anywhere": ["rpc-anywhere@1.5.0", "", { "dependencies": { "browser-namespace": "^1.4.0" } }, "sha512-ZYrB0foAM4oE7oBnUH3BL7LwtW9d6+RkzL/rFnjj8GCaFt5c81Rbw6oVl6u9AMsGONsKeJX0mL62TpbPXSO6og=="],
+
+    "tar": ["tar@6.2.1", "", { "dependencies": { "chownr": "^2.0.0", "fs-minipass": "^2.0.0", "minipass": "^5.0.0", "minizlib": "^2.1.1", "mkdirp": "^1.0.3", "yallist": "^4.0.0" } }, "sha512-DZ4yORTwrbTj/7MZYq2w+/ZFdI6OZ/f9SFHR+71gIVUZhOQPHzVCLpvRnPgyaMpfWxxk/4ONva3GQSyNIKRv6A=="],
+
+    "undici-types": ["undici-types@7.8.0", "", {}, "sha512-9UJ2xGDvQ43tYyVMpuHlsgApydB8ZKfVYTsLDhXkFL/6gfkp+U8xTGdh8pMJv1SpZna0zxG1DwsKZsreLbXBxw=="],
+
+    "yallist": ["yallist@4.0.0", "", {}, "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A=="],
+
+    "fs-minipass/minipass": ["minipass@3.3.6", "", { "dependencies": { "yallist": "^4.0.0" } }, "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw=="],
+
+    "minizlib/minipass": ["minipass@3.3.6", "", { "dependencies": { "yallist": "^4.0.0" } }, "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw=="],
+  }
+}

package/templates/hello-world/electrobun.config

@@ -0,0 +1,12 @@
+{
+    "app": {
+        "name": "hellow-world",
+        "identifier": "helloworld.electrobun.dev",
+        "version": "0.0.1"
+    },
+    "build": {
+        "mac": {
+            "bundleCEF": false
+        }
+    },
+}

package/templates/hello-world/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "electrobun-hello-world",
+  "version": "1.0.0",
+  "description": "A simple Electrobun app showcasing core features",
+  "scripts": {
+    "dev": "electrobun dev",
+    "build": "electrobun build",
+    "start": "bun run build && bun run dev"
+  },
+  "dependencies": {
+    "electrobun": "latest"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
+}

package/templates/hello-world/src/bun/index.ts

@@ -0,0 +1,15 @@
+import { BrowserWindow } from "electrobun/bun";
+
+// Create the main application window
+const mainWindow = new BrowserWindow({
+  title: "Hello Electrobun!",
+  url: "views://main/index.html",
+  frame: {
+    width: 800,
+    height: 600,
+    x: 200,
+    y: 200,
+  },
+});
+
+console.log("Hello Electrobun app started!");

package/templates/hello-world/src/mainview/index.css

@@ -0,0 +1,124 @@
+* {
+    box-sizing: border-box;
+}
+
+body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+    margin: 0;
+    padding: 0;
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    color: #333;
+    min-height: 100vh;
+}
+
+.container {
+    max-width: 800px;
+    margin: 0 auto;
+    padding: 40px 20px;
+}
+
+h1 {
+    color: white;
+    font-size: 3rem;
+    text-align: center;
+    margin-bottom: 8px;
+    text-shadow: 0 2px 4px rgba(0, 0, 0, 0.3);
+}
+
+.subtitle {
+    color: rgba(255, 255, 255, 0.9);
+    font-size: 1.25rem;
+    text-align: center;
+    margin-top: 0;
+    margin-bottom: 40px;
+    text-shadow: 0 1px 2px rgba(0, 0, 0, 0.3);
+}
+
+.welcome-section {
+    background: white;
+    border-radius: 12px;
+    padding: 30px;
+    margin: 30px 0;
+    box-shadow: 0 8px 25px rgba(0, 0, 0, 0.15);
+    line-height: 1.6;
+}
+
+h2 {
+    color: #2563eb;
+    margin-top: 30px;
+    margin-bottom: 15px;
+}
+
+ul {
+    margin: 20px 0;
+    padding-left: 20px;
+}
+
+li {
+    margin: 8px 0;
+}
+
+.links {
+    display: flex;
+    gap: 15px;
+    margin: 25px 0;
+    flex-wrap: wrap;
+}
+
+.doc-link {
+    display: inline-block;
+    background: #2563eb;
+    color: white;
+    text-decoration: none;
+    padding: 12px 20px;
+    border-radius: 8px;
+    font-weight: 500;
+    transition: all 0.2s ease;
+    box-shadow: 0 2px 4px rgba(37, 99, 235, 0.2);
+}
+
+.doc-link:hover {
+    background: #1d4ed8;
+    transform: translateY(-1px);
+    box-shadow: 0 4px 8px rgba(37, 99, 235, 0.3);
+}
+
+code {
+    background: #f1f5f9;
+    color: #475569;
+    padding: 2px 6px;
+    border-radius: 4px;
+    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
+    font-size: 0.9em;
+}
+
+.footer {
+    text-align: center;
+    color: rgba(255, 255, 255, 0.8);
+    margin-top: 40px;
+    padding: 20px;
+    background: rgba(255, 255, 255, 0.1);
+    border-radius: 8px;
+    backdrop-filter: blur(10px);
+}
+
+.footer p {
+    margin: 8px 0;
+}
+
+/* Dark mode support */
+@media (prefers-color-scheme: dark) {
+    .welcome-section {
+        background: #1f2937;
+        color: #f3f4f6;
+    }
+    
+    h2 {
+        color: #60a5fa;
+    }
+    
+    code {
+        background: #374151;
+        color: #d1d5db;
+    }
+}

package/templates/hello-world/src/mainview/index.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Hello Electrobun!</title>
+    <link rel="stylesheet" href="index.css">
+</head>
+<body>
+    <div class="container">
+        <h1>Hello Electrobun! 🎉</h1>
+        <p class="subtitle">A fast, cross-platform desktop app framework</p>
+        
+        <div class="welcome-section">
+            <p>Welcome to your first Electrobun app! This framework combines the power of Bun with native desktop capabilities.</p>
+            
+            <h2>What is Electrobun?</h2>
+            <ul>
+                <li><strong>Fast:</strong> Built on Bun's lightning-fast JavaScript runtime</li>
+                <li><strong>Native:</strong> Access to system APIs like menus, trays, and file dialogs</li>
+                <li><strong>Cross-platform:</strong> Works on macOS, Windows, and Linux</li>
+                <li><strong>Web-based UI:</strong> Use familiar HTML, CSS, and JavaScript for your interface</li>
+            </ul>
+            
+            <h2>Get Started</h2>
+            <p>Ready to build something amazing? Check out the documentation and examples:</p>
+            
+            <div class="links">
+                <a href="https://docs.electrobun.dev" target="_blank" class="doc-link">
+                    📚 Documentation
+                </a>
+                <a href="https://github.com/blackboardsh/electrobun" target="_blank" class="doc-link">
+                    🐙 GitHub Repository
+                </a>
+                <a href="https://docs.electrobun.dev/examples" target="_blank" class="doc-link">
+                    💡 Examples
+                </a>
+            </div>
+        </div>
+
+        <div class="footer">
+            <p>Edit <code>src/bun/index.ts</code> and <code>src/mainview/</code> to customize your app</p>
+            <p>Press F12 to open DevTools</p>
+        </div>
+    </div>
+</body>
+</html>

package/templates/hello-world/src/mainview/index.ts

@@ -0,0 +1,5 @@
+// Simple Hello World - no RPC needed for this basic template
+console.log("Hello Electrobun view loaded!");
+
+// You can add interactive functionality here
+// For RPC communication with the Bun process, check out the playground example