@geastack/cli 0.1.7 → 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,13 +43,15 @@ 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"]
 
   auto["Automation flags"] -.-> starter
-  auto --> autoEmpty["--starter empty --yes"]
+  auto --> autoEmpty["--starter blank --yes"]
   auto --> autoExample["--starter example --example watch"]
 ```
 
@@ -157,6 +161,6 @@ First implementation is in place:
 - npm-resolved embedded board builds for ESP32 and RP2350;
 - `flash`, `monitor`, WiFi OTA, and BLE OTA through `@geastack/targets`;
 - `list` and `inspect` helpers;
-- `create-geastack` with a bundled counter starter, an empty starter, and a
+- `create-geastack` with a bundled counter starter, a blank application, and a
   GitHub-backed rich example flow for web, embedded, GeaOS, iOS, macOS, and Android apps,
   all with `.gea/boards.json`.

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,
@@ -69,7 +70,7 @@ Automation can skip prompts:
 
 ```sh
 npx @geastack/create-geastack my-app --starter counter
-npx @geastack/create-geastack my-app --starter empty --yes
+npx @geastack/create-geastack my-app --starter blank --yes
 npx @geastack/create-geastack my-app --starter example --example watch
 npx @geastack/create-geastack my-ios-app --starter example --example ios-native-showcase
 npx gea build --target ios --mode simulator

package/docs/SPEC.md

@@ -120,7 +120,7 @@ or optional dependency is missing.
 Scaffolds a new app folder with:
 
 - `package.json` containing a `gea` manifest;
-- a bundled counter starter, an empty starter, or a selected GitHub example;
+- a bundled counter starter, a blank application, or a selected GitHub example;
 - `index.tsx` or `index.ts`;
 - `tsconfig.json`;
 - `vite.config.ts`;
@@ -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.7",
+  "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,
@@ -106,7 +106,7 @@ export async function runCreateGeastack(argv, io = {}) {
   stdout(`Created ${displayName} at ${targetDir}`)
   if (starter.kind === 'bundled') stdout(`Starter: ${starter.starter.name}`)
   else if (starter.kind === 'example') stdout(`Example: fetched ${starter.example.name}`)
-  else stdout('Starter: empty app')
+  else stdout('Starter: blank application')
   if (installDependencies) stdout(`Next: cd ${targetDir} && npx gea setup`)
   else stdout(`Next: cd ${targetDir} && npm install && npx gea setup`)
   return 0
@@ -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
@@ -134,10 +150,10 @@ async function resolveStarter(ctx, parsed, io) {
       return { kind: 'bundled', starter }
     }
     if (mode !== 'example') {
-      fail(`Unknown starter '${mode}'. Expected counter, empty, or example.`, ExitCode.usage)
+      fail(`Unknown starter '${mode}'. Expected counter, blank, or example.`, ExitCode.usage)
     }
     if (examples.length === 0) {
-      fail('No GitHub examples are available. Use --starter counter or --starter empty.', ExitCode.usage)
+      fail('No GitHub examples are available. Use --starter counter or --starter blank.', ExitCode.usage)
     }
 
     const requestedExample = option(parsed, 'example') || option(parsed, 'from-example') || ''
@@ -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')