shipthis 0.1.30 → 0.1.32

package/README.md

@@ -14,7 +14,7 @@
   <b>ShipThis</b> is a <b>command line tool</b> for building and uploading your <a href="https://godotengine.org/">Godot</a> mobile games to the <b>Apple App Store</b> and <b>Google Play</b>.
 </p>
 <p align="center">
-  ShipThis compiles your game on managed cloud servers — no local build tools needed. Use it manually or add it into your CI when you're ready to ship.
+  ShipThis compiles your game on managed cloud servers. You do not need Xcode, Android Studio, or SDK installations. You can run it manually or from CI.
 </p>
 
 <p align="center">
@@ -29,45 +29,22 @@
 
 ---
 
+## Why use ShipThis?
 
-<details>
-<summary><strong>Watch: Set up ShipThis for iOS</strong></summary>
+- **Always a free tier** - Enough build minutes for most solo devs
+- **One-command setup** - Use the interactive [`wizard`](https://shipth.is/docs/reference/game/wizard) to configure your game
+- **No additional tools** - No Xcode, Android Studio, or SDK installation required
+- **Simplified provisioning** - We handle iOS certificates, Android keystores, app signing, and API keys
+- **One-command deployment** - Publish to TestFlight or Google Play with a single command
 
-<p align="center">
-  <a href="https://www.youtube.com/watch?v=ijTUFVk1duw" target="_blank">
-    <img src="https://img.youtube.com/vi/ijTUFVk1duw/0.jpg" alt="Watch the iOS setup video" width="640" height="480">
-  </a>
-</p>
+## Quick start
 
-</details>
-<details>
-<summary><strong>Watch: Set up ShipThis for Android</strong></summary>
-
-<p align="center">
-  <picture>
-    <img height="431" width="672" alt="ShipThis Command - Android Wizard - published game" src="docs/assets/wizard-android-existingx0.5.gif">
-  </picture>
-</p>
-
-</details>
-
-
-## ❓ Why use ShipThis?
-
-- **✅ Always a free tier** – Enough usage for most solo devs.
-- **✨ One-command setup** – Our interactive [`wizard`](https://shipth.is/docs/reference/game/wizard) guides you through configuration.
-- **⏩ Skip the build tools** – No Xcode, Android Studio, or SDK installation required.
-- **🔐 Simplify provisioning** – We handle iOS certificates, Android keystores, app signing, and API keys.
-- **🚀 One-command deployment** – Publish to TestFlight or Google Play with a single CLI command.
-
-## ⚡️ Quick start
-
-### What you'll need
+### Requirements
 
 - A Godot 3.6 or 4.X game
 - [Node.js](https://nodejs.org/en/download/) version 18.0 or above
-- **If you are building an iOS game** – an [Apple Developer account](https://developer.apple.com)
-- **If you are building an Android game** – a [Play Console developer account](https://play.google.com/apps/publish/signup)
+- **To publish an Android game** - a [Play Console developer account](https://play.google.com/apps/publish/signup) (not required for building an APK/AAB)
+- **To build an iOS game** - an [Apple Developer account](https://developer.apple.com)
 
 ### 1. Install ShipThis
 
@@ -81,7 +58,7 @@ npm install -g shipthis
 
 Set up an account with ShipThis by logging in for the first time using the [`shipthis login`](https://shipth.is/docs/reference/login) command.
 
-> 🛠 All builds run on managed cloud servers – no need to install Xcode or Android Studio locally.
+> 🛠 All builds run on managed cloud servers - no need to install Xcode or Android Studio locally.
 
 ```bash
 shipthis login
@@ -89,20 +66,42 @@ shipthis login
 
 ### 3. Set up your game
 
-Next, run the [wizard command](https://shipth.is/docs/reference/game/wizard) to configure your game on ShipThis. The command takes a platform parameter – this can be either **android** or **ios**. Run this command from within a Godot game directory (with a **project.godot** file):
+Run the [wizard command](https://shipth.is/docs/reference/game/wizard) to configure your game on ShipThis. The command takes a platform parameter - this can be either **android** or **ios**. Run this command from within a Godot game directory (with a **project.godot** file):
 
-### Set up an Android game
+#### Set up an Android game
 
 ```bash
 shipthis game wizard android
 ```
 
-### Set up an iOS game
+<details>
+<summary><strong>Watch: Set up ShipThis for Android</strong></summary>
+
+<p align="center">
+  <picture>
+    <img height="431" width="672" alt="ShipThis Command - Android Wizard - published game" src="docs/assets/wizard-android-existingx0.5.gif">
+  </picture>
+</p>
+
+</details>
+
+#### Set up an iOS game
 
 ```bash
 shipthis game wizard ios
 ```
 
+<details>
+<summary><strong>Watch: Set up ShipThis for iOS</strong></summary>
+
+<p align="center">
+  <a href="https://www.youtube.com/watch?v=ijTUFVk1duw" target="_blank">
+    <img src="https://img.youtube.com/vi/ijTUFVk1duw/0.jpg" alt="Watch the iOS setup video" width="640" height="480">
+  </a>
+</p>
+
+</details>
+
 ### 4. Ship
 
 Now you can publish new versions of your game to TestFlight or Google Play with the [`shipthis game ship`](https://shipth.is/docs/reference/game/ship) command:
@@ -111,8 +110,90 @@ Now you can publish new versions of your game to TestFlight or Google Play with
 shipthis game ship
 ```
 
-- 💡 Having issues? Check the [Troubleshooting](https://shipth.is/docs/troubleshooting) or [join our Discord](https://discord.gg/gPjn3S99k4)
-- 📚 For detailed documentation, visit [shipth.is/docs](https://shipth.is/docs)
+- Having issues? Check the [Troubleshooting](https://shipth.is/docs/troubleshooting) or [join our Discord](https://discord.gg/gPjn3S99k4)
+- For detailed documentation, visit [shipth.is/docs](https://shipth.is/docs)
+
+
+## FAQ
+
+<details>
+<summary><strong>Can I build my game as APK without a Google Play account?</strong></summary>
+
+---
+
+Yes.
+
+Running the wizard command will create a Service Account Key for automatic publishing, you might not need this when initially building your game.
+
+You can run the steps below to create a ShipThis account, create the game, create a keystore, and then run the ship command. Later, when you need to setup publishing you can re-run the wizard command.
+
+
+```bash
+# Create or login to your shipthis account (OTP based login)
+shipthis login --email me@email.com
+
+# Create a ShipThis game - run this in a dir with a project.godot file
+shipthis game create --name "My Game" --androidPackageName "com.my.game"
+
+# Create a keystore for signing the APK
+shipthis game android keyStore create
+
+# Run the build, skip the publish step, and download as game.apk
+shipthis game ship --follow --platform android --skipPublish --downloadAPK game.apk
+```
+
+
+</details>
+
+
+<details>
+<summary><strong>Do I need a Mac to build for iOS?</strong></summary>
+
+---
+
+No, you do not need a Mac, but you will need an Apple Developer Account.
+
+ShipThis handles iOS builds on managed macOS cloud servers. The command-line tool communicates with the Apple Developer Portal to configure everything on your behalf.
+
+</details>
+
+<details>
+<summary><strong>Which versions of Godot are supported?</strong></summary>
+
+---
+
+We support **all stable Godot versions since 3.6**, including:
+
+| 3.6     | 4.0      | 4.1      | 4.2    | 4.3 | 4.4    |
+|---------|----------|----------|--------|-----|--------|
+| 3.6.1   | 4.0.1    | 4.1.1    | 4.2.1  |     | 4.4.1  |
+|         | 4.0.2    | 4.1.2    | 4.2.2  |     |        |
+|         | 4.0.3    | 4.1.3    |        |     |        |
+|         | 4.0.4    | 4.1.4    |        |     |        |
+
+You can read more in our [Godot versioning guide](https://shipth.is/docs/guides/godot-versioning).
+
+</details>
+
+<details>
+<summary><strong>Do I need to create an export_presets.cfg file?</strong></summary>
+
+---
+
+No, the ShipThis build server will generate a valid **export_presets.cfg** for your game.
+
+If you provide an **export_presets.cfg** file, the desired preset values will be merged with the generated file.
+
+</details>
+
+<details>
+<summary><strong>How much does it cost to use ShipThis?</strong></summary>
+
+---
+
+ShipThis is currently in open-beta as so it is completely free to use. You can see our planned pricing on the [pricing page](https://shipth.is/pricing).
+
+</details>
 
 ## 📖 Command Reference
 
@@ -132,4 +213,4 @@ shipthis game ship
 
 - 💬 [Join us on Discord](https://discord.gg/gPjn3S99k4)
 - 🐛 [Report an issue](https://github.com/shipth-is/cli/issues)
-- 📣 Feature ideas? Feedback? We’d love to hear from you – email support@shipth.is
+- 📣 Feature ideas? Feedback? We’d love to hear from you – email support@shipth.is

package/assets/markdown/create-google-play-game.md

@@ -1,14 +1,12 @@
 # Create the game in Google Play
 
-You will need to manually create an "app" in Google Play. This will involve entering the name, agreeing to Google Play's TOS and uploading an initial build (created in the previous step).
-
-Broadly, the steps are:
+You will need to manually create an "app" in Google Play.
 
 1. Log into the **Google Play Console** with your Google account. [https://play.google.com/console](https://play.google.com/console)
 1. Create a developer account and payments profile if prompted.
 1. Click **"Create app"** on the Console dashboard.
 1. Enter the app name, default language, and accept terms.
-1. Go to **"Internal testing"** and create a new release.
+1. Go to **"Test and release"** > **"Testing"** > **"Internal testing"** and create a new release.
 1. Upload the initial build **AAB file** of your game from the previous step
 
 To download the AAB file from the previous step, please run:

package/assets/markdown/ship-success.md

@@ -1,6 +1,6 @@
 # 🚀 Shipped
 
-**Your game has been successfully built and published.**
+**Your game has been successfully built${if wasPublished} and published${endif}.**
 
 ## Next Steps
 

package/dist/{AppleBundleIdDetails-Fp5COwTa.js → AppleBundleIdDetails-6H3cNWxw.js}

@@ -1,37 +1,37 @@
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { Box, Text } from 'ink';
 import Spinner from 'ink-spinner';
-import './index-DxzXU9Hd.js';
-import 'axios';
-import '@tanstack/react-query';
-import 'crypto';
-import 'fs';
-import 'readline-sync';
-import 'node:readline';
+import '@inkjs/ui';
+import 'node:crypto';
+import 'node:fs';
 import 'node:path';
+import 'node:readline';
 import 'node:url';
+import 'readline-sync';
 import 'luxon';
+import 'axios';
 import 'isomorphic-git';
+import './index-BhhiXbey.js';
 import '@oclif/core';
+import '@tanstack/react-query';
 import 'react';
 import 'crypto-js';
 import 'uuid';
-import 'socket.io-client';
-import { u as useAppleApp } from './useAppleApp-cnb8gX0x.js';
+import { u as useAppleApp } from './useAppleApp-DWYGURwU.js';
 import 'fast-glob';
 import 'yazl';
-import '@inkjs/ui';
-import './index-BTAL7EB_.js';
-import 'open';
-import { T as Table } from './Table-CvM6pccN.js';
+import 'socket.io-client';
+import 'fullscreen-ink';
+import { T as Table } from './Table-FaNgpyeq.js';
 import { T as Title } from './Title-BCQtayg6.js';
 import 'string-length';
 import 'strip-ansi';
+import 'open';
+import './index-C66Dd8Xc.js';
 import 'marked';
 import 'marked-terminal';
-import 'path';
 import 'qrcode';
-import { u as useAppleBundleId } from './useAppleBundleId-B0Etav8g.js';
+import { u as useAppleBundleId } from './useAppleBundleId-PsTJ2g1B.js';
 
 const AppleAppDetails = (props) => {
   const { data, isLoading } = useAppleApp(props);
@@ -44,7 +44,7 @@ const AppleAppDetails = (props) => {
 
 const AppleBundleIdDetails = (props) => {
   const { data, isLoading } = useAppleBundleId(props);
-  const { bundleIdSummary, capabilitiesTable, shouldSyncCapabilities, capabilities } = data || {};
+  const { bundleIdSummary, capabilities, capabilitiesTable, shouldSyncCapabilities } = data || {};
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [
       /* @__PURE__ */ jsx(Title, { children: "BundleId Details (in the Apple Developer Portal)" }),
@@ -56,9 +56,7 @@ const AppleBundleIdDetails = (props) => {
       /* @__PURE__ */ jsx(
         Table,
         {
-          data: capabilities.map((c) => {
-            return { capability: `${c}` };
-          })
+          data: capabilities.map((c) => ({ capability: `${c}` }))
         }
       )
     ] }),

package/dist/{Command-1p5alCz3.js → Command-WPpmLPkL.js}

@@ -1,28 +1,29 @@
 import { jsx } from 'react/jsx-runtime';
-import { Box } from 'ink';
 import { QueryClientProvider } from '@tanstack/react-query';
-import { K as queryClient } from './index-DxzXU9Hd.js';
+import { useScreenSize } from 'fullscreen-ink';
+import { Box } from 'ink';
+import { K as queryClient } from './index-BhhiXbey.js';
 import 'axios';
-import 'crypto';
-import 'fs';
-import 'readline-sync';
-import 'node:readline';
+import 'node:fs';
+import 'crypto-js';
+import 'uuid';
+import 'luxon';
+import 'node:crypto';
 import 'node:path';
+import 'node:readline';
 import 'node:url';
-import 'luxon';
+import 'readline-sync';
 import 'isomorphic-git';
 import '@oclif/core';
 import 'react';
-import 'crypto-js';
-import 'uuid';
 import 'socket.io-client';
 import 'fast-glob';
 import 'yazl';
-import { C as CommandProvider } from './index-BTAL7EB_.js';
+import { b as CommandProvider } from './index-C66Dd8Xc.js';
 
 const Command = ({ children, command }) => {
-  const width = process.stdout.columns || 80;
-  return /* @__PURE__ */ jsx(QueryClientProvider, { client: queryClient, children: /* @__PURE__ */ jsx(CommandProvider, { command, children: /* @__PURE__ */ jsx(Box, { width, flexDirection: "column", children }) }) });
+  const { width } = useScreenSize();
+  return /* @__PURE__ */ jsx(QueryClientProvider, { client: queryClient, children: /* @__PURE__ */ jsx(CommandProvider, { command, children: /* @__PURE__ */ jsx(Box, { flexDirection: "column", width, children }) }) });
 };
 
 export { Command as C };

package/dist/CommandGame-cxzWG4nT.js

@@ -0,0 +1,7 @@
+import { jsx } from 'react/jsx-runtime';
+import { c as GameProvider } from './index-C66Dd8Xc.js';
+import { C as Command } from './Command-WPpmLPkL.js';
+
+const CommandGame = ({ children, command }) => /* @__PURE__ */ jsx(Command, { command, children: /* @__PURE__ */ jsx(GameProvider, { children }) });
+
+export { CommandGame as C };

package/dist/{Create-1xAdntNl.js → Create-3Ob8sjik.js}

@@ -1,34 +1,34 @@
 import { jsx } from 'react/jsx-runtime';
-import { Box } from 'ink';
+import { useQueryClient } from '@tanstack/react-query';
 import axios from 'axios';
+import { Box } from 'ink';
 import { useContext } from 'react';
-import { useQueryClient } from '@tanstack/react-query';
-import { p as getAuthedHeaders, q as API_URL } from './index-DxzXU9Hd.js';
-import { c as cacheKeys } from './useAndroidServiceAccountTestResult-CJLIEYmA.js';
-import { b as GameContext } from './index-BTAL7EB_.js';
+import { p as getAuthedHeaders, o as API_URL } from './index-BhhiXbey.js';
 import 'ink-spinner';
-import '@inkjs/ui';
-import 'fs';
-import 'uuid';
-import 'yazl';
-import 'crypto';
-import 'readline-sync';
-import 'node:readline';
+import 'node:crypto';
+import 'node:fs';
 import 'node:path';
+import 'node:readline';
 import 'node:url';
+import 'readline-sync';
 import 'luxon';
 import 'isomorphic-git';
 import '@oclif/core';
+import { c as cacheKeys } from './useAndroidServiceAccountTestResult-DZk5SMxI.js';
 import 'fast-glob';
+import 'uuid';
+import 'yazl';
 import 'socket.io-client';
+import 'fullscreen-ink';
+import 'string-length';
+import 'strip-ansi';
 import 'open';
+import '@inkjs/ui';
 import 'marked';
 import 'marked-terminal';
-import 'path';
 import 'qrcode';
-import { R as RunWithSpinner } from './RunWithSpinner-BVXNWGD3.js';
-import 'string-length';
-import 'strip-ansi';
+import { R as RunWithSpinner } from './RunWithSpinner-gMVA07bZ.js';
+import { G as GameContext } from './index-C66Dd8Xc.js';
 
 const CreateKeystore = ({ onComplete, onError, ...boxProps }) => {
   const { gameId } = useContext(GameContext);
@@ -40,17 +40,17 @@ const CreateKeystore = ({ onComplete, onError, ...boxProps }) => {
       await axios.post(`${API_URL}/projects/${gameId}/credentials/android/certificate`, null, {
         headers
       });
-      queryClient.invalidateQueries({ queryKey: cacheKeys.projectCredentials({ projectId: gameId, pageNumber: 0 }) });
-    } catch (err) {
-      onError(err);
+      queryClient.invalidateQueries({ queryKey: cacheKeys.projectCredentials({ pageNumber: 0, projectId: gameId }) });
+    } catch (error) {
+      onError(error);
     }
   };
   return /* @__PURE__ */ jsx(Box, { flexDirection: "column", gap: 1, ...boxProps, children: gameId && /* @__PURE__ */ jsx(
     RunWithSpinner,
     {
       executeMethod: handleCreate,
-      msgInProgress: "Creating Keystore...",
       msgComplete: "Keystore created",
+      msgInProgress: "Creating Keystore...",
       onComplete
     }
   ) });

package/dist/GameStatus-BQEtVKvv.js

@@ -0,0 +1,137 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { Text, Box } from 'ink';
+import { useState, useEffect, useContext } from 'react';
+import { b as getShortDate, P as Platform, E as getProject, F as getProjectPlatformProgress } from './index-BhhiXbey.js';
+import 'ink-spinner';
+import { g as getShortUUID, m as makeHumanReadable } from './index-CGBdOm1q.js';
+import '@tanstack/react-query';
+import 'axios';
+import 'luxon';
+import 'node:fs';
+import 'fast-glob';
+import 'uuid';
+import 'yazl';
+import 'socket.io-client';
+import 'fullscreen-ink';
+import 'string-length';
+import 'strip-ansi';
+import { S as StatusTable } from './StatusTable-DzRWcMr4.js';
+import 'open';
+import '@inkjs/ui';
+import 'node:path';
+import 'marked';
+import 'marked-terminal';
+import { N as NextSteps } from './NextSteps-DbJHmscQ.js';
+import 'qrcode';
+import { G as GameContext, C as CommandContext } from './index-C66Dd8Xc.js';
+
+function isPlatformConfigured(platform, progress) {
+  if (!progress) return false;
+  return progress.platform === platform && progress.hasBundleSet && progress.hasCredentialsForPlatform && progress.hasApiKeyForPlatform;
+}
+function getSteps(platform, progress) {
+  if (!progress) return ["shipthis game wizard " + platform.toLowerCase()];
+  switch (platform) {
+    case Platform.ANDROID: {
+      return [
+        !progress.hasCredentialsForPlatform && "shipthis game android keyStore create",
+        !progress.hasApiKeyForPlatform && "shipthis game android apiKey create",
+        isPlatformConfigured(platform, progress) && "shipthis game ship"
+      ].filter(Boolean);
+    }
+    case Platform.IOS: {
+      return [
+        !progress.hasApiKeyForPlatform && "shipthis apple apiKey create",
+        !progress.hasCredentialsForPlatform && "shipthis game ios profile create",
+        isPlatformConfigured(platform, progress) && "shipthis game ship"
+      ].filter(Boolean);
+    }
+    default: {
+      throw new Error("Invalid platform");
+    }
+  }
+}
+async function fetchGameStatus(gameId, platforms) {
+  const game = await getProject(gameId);
+  const isEnabled = {};
+  const statuses = {};
+  for (const platform of platforms) {
+    isEnabled[platform] = platform === Platform.IOS ? Boolean(game.details?.iosBundleId) : Boolean(game.details?.androidPackageName);
+    if (isEnabled[platform]) {
+      statuses[platform] = await getProjectPlatformProgress(game.id, platform);
+    }
+  }
+  let steps = [];
+  for (const platform of platforms) {
+    steps = steps.concat(getSteps(platform, statuses[platform]));
+  }
+  let exitCode = 0;
+  for (const platform of platforms) {
+    const platformStatus = statuses[platform];
+    if (!platformStatus) continue;
+    const hasConfigError = isEnabled[platform] && !isPlatformConfigured(platform, platformStatus);
+    if (hasConfigError) exitCode = exitCode || 1;
+  }
+  if (platforms.length === 1 && !isEnabled[platforms[0]]) {
+    exitCode = exitCode || 1;
+  } else if (platforms.length > 1 && !isEnabled[Platform.IOS] && !isEnabled[Platform.ANDROID]) {
+    exitCode = exitCode || 1;
+  }
+  return {
+    exitCode,
+    game,
+    isEnabled,
+    statuses,
+    steps
+  };
+}
+const GameStatusDetails = ({ children, gameId, onComplete, onError, platforms }) => {
+  const [state, setState] = useState(null);
+  useEffect(() => {
+    fetchGameStatus(gameId, platforms).then((res) => {
+      setState(res);
+      setTimeout(() => onComplete?.(res.exitCode), 0);
+    }).catch((error) => onError?.(error));
+  }, []);
+  if (!state) return /* @__PURE__ */ jsx(Text, {});
+  const { game, statuses, steps } = state;
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx(
+      StatusTable,
+      {
+        statuses: {
+          "Build Number": `${game.details?.buildNumber || 1}`,
+          "Created At": getShortDate(game.createdAt),
+          "Game Engine": `${game.details?.gameEngine || "godot"} ${game.details?.gameEngineVersion || "4.3"}`,
+          "Game ID": getShortUUID(game.id),
+          Name: game.name,
+          Version: game.details?.semanticVersion || "0.0.1"
+        },
+        title: "Game Details"
+      }
+    ),
+    platforms.map((platform) => {
+      const status = statuses[platform];
+      const label = platform === Platform.IOS ? "iOS" : "Android";
+      const color = platforms.length === 1 ? "red" : "yellow";
+      const { platform: _, ...statusValues } = status || {};
+      return /* @__PURE__ */ jsx(Box, { marginTop: 1, children: status ? /* @__PURE__ */ jsx(StatusTable, { statuses: makeHumanReadable(statusValues), title: `${label} Status` }) : /* @__PURE__ */ jsxs(Text, { color, children: [
+        "The ",
+        label,
+        " platform is not enabled for this game."
+      ] }) }, platform);
+    }),
+    children,
+    /* @__PURE__ */ jsx(NextSteps, { steps })
+  ] });
+};
+const GameStatus$1 = ({ children, onComplete }) => {
+  const { gameId } = useContext(GameContext);
+  const { command } = useContext(CommandContext);
+  const flags = command && command.getFlags() || {};
+  const platforms = flags.platform ? [flags.platform.toUpperCase()] : [Platform.IOS, Platform.ANDROID];
+  if (!gameId) return null;
+  return /* @__PURE__ */ jsx(GameStatusDetails, { gameId, onComplete, platforms, children });
+};
+
+export { GameStatusDetails as G, GameStatus$1 as a };