Fix npm CLI package: use Node.js launcher shim instead of postinstall

The bin/lightshell file is now a Node.js shim that finds and executes
the platform-specific binary at runtime (like esbuild). This replaces
the broken postinstall approach where the binary wasn't included in
the published package. Also updates README with scoped package names.

Author: meherpanguluri

README.md

@@ -7,7 +7,16 @@ Build desktop apps with JavaScript. Ship them under 5MB.
 ## Quick Start
 
 ```bash
-npm create lightshell@latest my-app
+npx @lightshell/create my-app
+cd my-app
+npx @lightshell/cli dev
+```
+
+Or install globally:
+
+```bash
+npm install -g @lightshell/cli
+lightshell init my-app
 cd my-app
 lightshell dev
 ```

npm/lightshell/bin/lightshell

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+// This shim finds the platform-specific binary and executes it.
+// The actual binary lives in @lightshell/{platform} optional dependency.
+
+const { platform, arch } = process;
+const { execFileSync } = require("child_process");
+const path = require("path");
+
+const platformMap = { darwin: "darwin", linux: "linux" };
+const archMap = { arm64: "arm64", x64: "x64", x86_64: "x64" };
+
+const os = platformMap[platform];
+const cpu = archMap[arch];
+
+if (!os || !cpu) {
+  console.error(
+    `lightshell: unsupported platform ${platform}-${cpu || arch}. Only macOS and Linux (arm64, x64) are supported.`
+  );
+  process.exit(1);
+}
+
+const pkgName = `@lightshell/${os}-${cpu}`;
+
+let binaryPath;
+try {
+  binaryPath = require.resolve(`${pkgName}/lightshell`);
+} catch {
+  console.error(
+    `lightshell: could not find ${pkgName}.\n` +
+      `This usually means optional dependencies were not installed.\n` +
+      `Try: npm install @lightshell/cli --include=optional`
+  );
+  process.exit(1);
+}
+
+try {
+  const result = execFileSync(binaryPath, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+} catch (err) {
+  if (err.status !== null) {
+    process.exit(err.status);
+  }
+  console.error(`lightshell: failed to run binary: ${err.message}`);
+  process.exit(1);
+}

npm/lightshell/install.js

@@ -12,9 +12,9 @@
   "bin": {
     "lightshell": "bin/lightshell"
   },
-  "scripts": {
-    "postinstall": "node install.js"
-  },
+  "files": [
+    "bin/"
+  ],
   "optionalDependencies": {
     "@lightshell/darwin-arm64": "0.1.0",
     "@lightshell/darwin-x64": "0.1.0",