nukebase 2.0.0 → 2.0.1

package/bin/nukebase.js

@@ -20,6 +20,9 @@ function usage() {
 
 Usage: nukebase <command>        (or: npx nukebase <command>)
 
+New here? Run: npx nukebase start
+  signs you in, creates a project and downloads it, ready to build
+
 Accounts
   login                      sign in by approving in your browser
   login --email you@x.com    sign in as a specific account (adds it; others stay)
@@ -33,6 +36,8 @@ Accounts
   whoami                     who owns this project, and are you signed in
 
 New projects
+  start [name] [size]        outside a project: sign in if needed, then create
+                             (inside a project, start = restart)
   create <name> [size] [email]
                              make a project and download it, e.g.
                              nukebase create demoapp123 256mb you@example.com
@@ -79,15 +84,19 @@ dashboard under Signed-in devices).
 Sign-ins are kept in ~/.nukebase/credentials.json, never in a project.`);
 }
 
-const command = args.command;
+let command = args.command;
+
+// `start` means two things: inside a project it restarts the app (as it always
+// has); anywhere else it is the new-user setup (sign in, create, download).
+if (command === 'start' && !require('../lib/project').findProject(process.cwd())) command = 'setup';
 
 if (args.has('version') && !command) {
   console.log(version);
 } else if (!command || command === 'help' || (args.has('help') && !command)) {
   usage();
-} else if (ACCOUNT_COMMANDS.includes(command)) {
+} else if (ACCOUNT_COMMANDS.includes(command) || command === 'setup') {
   Promise.resolve()
-    .then(() => require('../lib/account-commands')[command](args))
+    .then(() => require('../lib/account-commands')[command === 'setup' ? 'start' : command](args))
     .then(() => process.exit(0), err => { console.error('❌', err.message); process.exit(1); });
 } else if (PROJECT_COMMANDS.includes(command)) {
   require('../lib/project-commands');

package/lib/account-commands.js

@@ -295,6 +295,10 @@ async function createCommand(args) {
     let msg = '';
     try { msg = (await res.json()).error; } catch {}
     if (res.status === 401) fail(`The sign-in for ${acct.label} is no longer valid. Run: nukebase login --email ${acct.label}`);
+    // No plan, or no credit: both are fixed on the dashboard.
+    if (res.status === 403 && /plan|funds|credit|wallet|balance/i.test(msg)) {
+      fail(`${msg}\n   Choose a plan or add credit at ${api}/`);
+    }
     fail(`Create failed (${res.status}): ${msg || res.statusText}`);
   }
 
@@ -319,6 +323,44 @@ async function createCommand(args) {
   console.log('   nukebase push      deploy your changes');
 }
 
+// ---- start ----------------------------------------------------------------
+// The one command a new user runs after signing up: sign in if needed, then
+// create a project and download it. `nukebase start [name] [size] [email]`.
+// (Inside a project folder `start` means restart; bin/nukebase.js routes it.)
+
+async function startCommand(args) {
+  const autoYes = args.has('yes');
+  const { parse } = require('./args');
+  const passFlags = [];
+  for (const f of ['api', 'region']) if (args.get(f)) passFlags.push(`--${f}`, args.get(f));
+  if (autoYes) passFlags.push('--yes');
+  if (args.has('no-install')) passFlags.push('--no-install');
+
+  console.log('\n  Welcome to NukeBase.');
+  const emailArg = args.positional.find(a => a.includes('@'));
+  if (!creds.list().length || (emailArg && !creds.find(emailArg))) {
+    console.log('\n  Step 1 of 2: sign in. Click Allow in the browser window that opens.');
+    await loginCommand(parse(['login', ...(emailArg ? ['--email', emailArg] : []), ...passFlags]));
+  }
+
+  console.log(`\n  ${creds.list().length ? 'Step 2 of 2: ' : ''}create your project`);
+  let name = args.positional.find(a => !a.includes('@') && PROJECT_NAME_RE.test(a));
+  if (!name) {
+    if (autoYes || !process.stdin.isTTY) fail('Give the project a name, e.g.: nukebase start myapp');
+    for (;;) {
+      name = (await makeAskLine(false)('\n  Project name (lowercase, e.g. myapp): ')).trim().toLowerCase();
+      if (!name) fail('No name given.');
+      if (PROJECT_NAME_RE.test(name)) break;
+      console.log('  3-31 characters: lowercase letters, numbers, - and _, starting with a letter.');
+    }
+  }
+  const rest = args.positional.filter(a => a !== name);
+  await createCommand(parse(['create', name, ...rest, ...passFlags]));
+
+  console.log('\n  Building with Claude Code? Open the folder and describe your app.');
+  console.log('  Its CLAUDE.md explains NukeBase, and Claude can deploy with: npx nukebase push --yes');
+}
+
 // ---- link -----------------------------------------------------------------
 
 async function linkCommand(args) {
@@ -364,6 +406,7 @@ module.exports = {
   use: useCommand,
   whoami: whoamiCommand,
   create: createCommand,
+  start: startCommand,
   link: linkCommand,
   resolveTier, sizeToMb
 };

package/lib/login.js

@@ -98,7 +98,13 @@ async function browser(api, { email } = {}) {
   console.log('  Waiting for approval…  (Ctrl+C to cancel)');
   openBrowser(url.toString());
 
-  const q = await result;
+  // The usual reason for a long wait: no account yet, so no sign-in email
+  // ever arrives (the server doesn't say which addresses have accounts).
+  const hint = setTimeout(() => {
+    console.log(`\n  Still waiting. No account yet? Sign up at ${api}/start.html first, then run this again.`);
+  }, 90 * 1000);
+  hint.unref();
+  const q = await result.finally(() => clearTimeout(hint));
   if (q.error) throw new Error('Sign-in was cancelled in the browser.');
   if (!q.code) throw new Error('The browser did not return a sign-in code.');
   const r = await postJson(`${api}/cli/token`, { code: q.code, verifier });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nukebase",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "NukeBase CLI: create, deploy and manage NukeBase projects",
   "bin": {
     "nukebase": "bin/nukebase.js"