@geastack/cli 0.1.8 → 0.1.9

package/README.md

@@ -31,8 +31,10 @@ flowchart TD
 
   starter -->|"Embedded component counter"| counter["Copy the touchscreen counter used in the embedded tutorial"]
 
-  starter -->|"Blank application"| empty["Generate a minimal browser application"]
-  empty --> emptyFiles["index.tsx, styles.css, index.html,<br/>tsconfig.json, vite.config.ts"]
+  starter -->|"Blank application"| emptyTarget{"Where should it run?"}
+  emptyTarget -->|"Web browser"| emptyWeb["Generate browser entry, HTML, and Vite config"]
+  emptyTarget -->|"ESP32 board"| emptyEsp["Generate native entry<br/>Ask whether to enable Bluetooth updates"]
+  emptyTarget -->|"Other native target"| emptyNative["Generate native entry for the selected platform"]
 
   starter -->|"Example application"| pickExample["Pick from the example gallery<br/>web, ESP32, GeaOS, iOS, macOS, Android"]
   pickExample --> fetchExample["Fetch selected app from GitHub"]
@@ -41,7 +43,9 @@ flowchart TD
 
   counter --> projectWiring["Add @geastack/core and @geastack/cli"]
   rewriteExample --> projectWiring["Add @geastack/core and @geastack/cli"]
-  emptyFiles --> projectWiring
+  emptyWeb --> projectWiring
+  emptyEsp --> projectWiring
+  emptyNative --> projectWiring
   projectWiring --> boardConfig["Create .gea/boards.json"]
   boardConfig --> install["Install npm dependencies<br/>(interactive default)"]
   install --> setup["Next: npx gea setup"]

package/docs/NPX-COMMANDS.md

@@ -53,9 +53,10 @@ What do you want to build?
 `Embedded component counter` is the bundled tutorial starter. It uses local
 component state, targets ESP32, and enables BLE updates.
 
-`Blank application` creates the smallest browser starter: `index.tsx`, `styles.css`,
-`index.html`, `tsconfig.json`, `vite.config.ts`, `package.json`, and
-`.gea/boards.json`.
+`Blank application` asks where the app should run. It creates the smallest
+project for that target and, for ESP32, asks whether to enable wireless
+firmware updates over Bluetooth. Browser-only files such as `index.html` and
+`vite.config.ts` are added only when the web target is selected.
 
 `Example application` opens an example picker populated from the hard-coded
 `examples/catalog.json` shipped inside `@geastack/cli`. The catalog contains web,

package/docs/SPEC.md

@@ -132,7 +132,8 @@ Interactive starter choices must explain the tradeoff in-line:
 
 - `Embedded component counter`: create a touchscreen counter with local
   component state, an ESP32 target, and BLE updates enabled.
-- `Blank application`: generate a minimal browser application as a clean slate.
+- `Blank application`: ask where the app should run, generate the matching
+  minimal project, and ask whether to enable Bluetooth updates for ESP32.
 - `Example application`: fetch a selected app from `geastack/examples`, then rewrite
   package name, app id, dependencies, and board config for the new project.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "type": "module",
   "description": "Command-line front door for GeaStack apps, targets, and local toolchains.",
   "publishConfig": {

package/src/create-geastack.mjs

@@ -5,7 +5,7 @@ import { flag, option, optionList, parseArgs } from './args.mjs'
 import { createContext } from './context.mjs'
 import { ExitCode, fail } from './errors.mjs'
 import { exists, readJson, writeJson } from './fs-utils.mjs'
-import { canPrompt, choose, createPrompt } from './prompts.mjs'
+import { canPrompt, choose, confirm, createPrompt } from './prompts.mjs'
 import { runExternal } from './run.mjs'
 import {
   copyStarterFiles,
@@ -67,12 +67,12 @@ export async function runCreateGeastack(argv, io = {}) {
   }
 
   const sourcePackage = readPackageJson(targetDir)
-  const sourceManifest = sourcePackage.gea || starter.starter?.manifest || starter.example?.manifest || {}
+  const sourceManifest = sourcePackage.gea || starter.manifest || starter.starter?.manifest || starter.example?.manifest || {}
   const requestedTargets = optionList(parsed, 'targets')
   const targets = requestedTargets.length > 0
     ? targetManifest(requestedTargets)
     : starter.kind === 'empty'
-      ? targetManifest(['web'])
+      ? targetManifest(starter.targets || ['web'])
       : targetManifestFromObject(sourceManifest.targets)
   writeJson(path.join(targetDir, 'package.json'), packageJson({
     appId,
@@ -121,7 +121,23 @@ async function resolveStarter(ctx, parsed, io) {
   try {
     const mode = requested || await chooseStarterMode({ interactive, prompt, bundled, examples })
 
-    if (mode === 'empty') return { kind: 'empty' }
+    if (mode === 'empty') {
+      const requestedTargets = optionList(parsed, 'targets')
+      if (!interactive || requestedTargets.length > 0) return { kind: 'empty' }
+
+      const target = await chooseBlankTarget(prompt)
+      const enableBleOta = target === 'esp32'
+        ? await confirm(prompt, {
+            message: 'Enable wireless firmware updates over Bluetooth?',
+            defaultValue: true
+          })
+        : false
+      return {
+        kind: 'empty',
+        targets: [target],
+        manifest: enableBleOta ? { ota: { ble: true } } : {}
+      }
+    }
     if (mode === 'bundled' || mode === 'counter') {
       const requestedBundled = mode === 'counter' ? 'counter' : option(parsed, 'bundled') || option(parsed, 'starter-id') || ''
       const starter = requestedBundled
@@ -191,6 +207,50 @@ async function chooseExample({ interactive, prompt, examples }) {
   return examples.find((example) => example.id === id) || null
 }
 
+async function chooseBlankTarget(prompt) {
+  return choose(prompt, {
+    message: 'Where should this application run?',
+    choices: [
+      {
+        value: 'web',
+        label: 'Web browser',
+        description: 'A browser app with a local development server.'
+      },
+      {
+        value: 'esp32',
+        label: 'ESP32 board',
+        description: 'Native firmware for a supported ESP32 device.'
+      },
+      {
+        value: 'rp2350',
+        label: 'RP2350 board',
+        description: 'Native firmware for a supported Raspberry Pi RP2350 device.'
+      },
+      {
+        value: 'geaos',
+        label: 'GeaOS device',
+        description: 'A native application for GeaOS.'
+      },
+      {
+        value: 'macos',
+        label: 'macOS',
+        description: 'A native Mac application.'
+      },
+      {
+        value: 'ios',
+        label: 'iPhone or iPad',
+        description: 'A native iOS application.'
+      },
+      {
+        value: 'android',
+        label: 'Android',
+        description: 'A native Android application.'
+      }
+    ],
+    defaultValue: 'web'
+  })
+}
+
 function ensureWritableTarget(targetDir, force) {
   if (!exists(targetDir)) return
   const entries = fs.readdirSync(targetDir).filter((entry) => entry !== '.DS_Store')