shipthis 0.0.32 → 0.0.33

package/docs/apple/apiKey.md

@@ -9,6 +9,8 @@ Commands in the apple apiKey topic are prefixed `shipthis apple apiKey`. These c
 
 :::info
 An **App Store Connect API key** is used to authenticate and authorize automated interactions with Apple's App Store Connect API, enabling tasks like managing app metadata, TestFlight, and sales reports.
+
+**ShipThis uses one of these keys to automatically upload new builds of your games.**
 :::
 
 :::tip

package/docs/apple/certificate.md

@@ -11,6 +11,8 @@ These commands relate to iOS Distribution Certificates within your Apple Develop
 
 :::info
 An **iOS Distribution Certificate** is used to authenticate and authorize the distribution of iOS apps, ensuring they are signed and trusted for installation on devices or submission to the App Store.
+
+**ShipThis uses this certificate on our cloud-build servers when compiling new builds of your game.**
 :::
 
 :::tip

package/docs/game/build.md

@@ -13,7 +13,7 @@ your game code. It should not be confused with the command [`shipthis game ship`
 
 ## Example
 
-[![asciicast](https://asciinema.org/a/m2i3bOvZHUpQXFWtYXc7UnaKQ.svg)](https://asciinema.org/a/m2i3bOvZHUpQXFWtYXc7UnaKQ)
+[![asciicast](https://asciinema.org/a/m2i3bOvZHUpQXFWtYXc7UnaKQ.svg)](https://asciinema.org/a/m2i3bOvZHUpQXFWtYXc7UnaKQ#shipthis-col160row32)
 
 ## Commands
 

package/docs/game/create.md

@@ -3,13 +3,13 @@
 ## Description
 
 :::tip
-We recommend configuring your game using the [`shipthis game wizard`](/docs/reference/game/wizard).
+We recommend creating your game using the [`shipthis game wizard`](/docs/reference/game/wizard).
 The `shipthis game create` command is the first step run by the wizard
 :::
 
 Creates a new game in your [ShipThis account](https://shipthis.cc/games).
 
-It will read the name of your game from your `project.godot` file. You will be
+ShipThis will read the name of your game from your `project.godot` file. You will be
 prompted to confirm this name, or you can specify one with the `--name` flag. 
 
 If there is already a ShipThis game config file (`shipthis.json`) in the current

package/docs/game/details.md

@@ -2,7 +2,7 @@
 
 ## Description
 
-Shows and sets the details of the current game.
+Shows and sets the details of the current game. These details are used by when your game is built on our cloud servers.
 
 If you run the command without any flags it will show the details of the current
 game.
@@ -12,10 +12,10 @@ value, it will output all the values again.
 
 The following fields can only be changed if you have the `--force` flag set:
 
-- `--gameEngine` - Change the Game Engine (currently only "godot" is supported)
-- `--gameEngineVersion` - Change the version of the Game Engine (currently only 3.6 and 4.3 are supported)
-- `--iosBundleId` - iOS Bundle ID
-- `--androidPackageName` Android Package Name (not currently used)
+- **gameEngine** - Change the Game Engine (currently only "godot" is supported)
+- **gameEngineVersion** - Change the version of the Game Engine (currently only 3.6 and 4.3 are supported)
+- **iosBundleId** - iOS Bundle ID
+- **androidPackageName** Android Package Name (not currently used)
 
 :::tip
 After changing these values, you will need to trigger a new build of your game with [`shipthis game ship`](/docs/reference/game/ship)

package/docs/game/export.md

@@ -4,6 +4,10 @@
 
 Downloads the shipthis.json file for a given game into the current directory.
 
+## Example
+
+[![asciicast](https://asciinema.org/a/kAclG6bghhwuXWP4E5NUssAfA.svg)](https://asciinema.org/a/kAclG6bghhwuXWP4E5NUssAfA#shipthis-col100row32)
+
 ## Help Output
 
 ```

package/docs/game/ios/app.md

@@ -1,19 +1,46 @@
 # Topic: `game ios app`
 
-Commands related to the App Store App for a specific game
+Commands in the `game ios app` topic are prefixed `shipthis game ios app`. They relate to the App Store App and BundleId for for a specific game (generally in the currently directory).
 
+:::info
+An **App Store App** is the public-facing application available in the App Store. It includes metadata like descriptions, screenshots, and submission details, representing the final product users download.
+
+A **Bundle ID** is a unique identifier for your app within Apple’s ecosystem. It connects your app to services, certificates, and provisioning profiles, ensuring it can be built, run, and managed correctly.
+
+**You can view the registered Bundle IDs (Identifiers) and their associated capabilities in the [Apple Developer Portal](https://developer.apple.com/account/resources/identifiers/list)**
+
+:::
+
+:::tip
+You will need to be authenticated against ShipThis and Apple before you can use
+these commands. To do that please run the following commands first:
+
+- [`shipthis login`](/docs/reference/login)
+- [`shipthis apple login`](/docs/reference/apple/login)
+
+:::
 
 ## Commands
 
-### game ios app create
+### `game ios app create`
 
 #### Description
 
-Creates an App and BundleId in the Apple Developer Portal.
+Creates an App and BundleId in the Apple Developer Portal. This command is run
+as part of the [`shipthis game wizard`](/docs/reference/game/wizard) command.
+
+When run, this command will register a new App Store App and BundleId using the App
+Store Connect API. It will ask you to confirm the name of the App and the BundleId
+string which is typically in the form of `com.mycompany.mygame`. Both of these need
+to be unique within the Apple ecosystem. ShipThis will suggest values for these.
+
+#### Example
+
+[![asciicast](https://asciinema.org/a/xc5B3aQjSDU3ErUjyi2oAYUvG.svg)](https://asciinema.org/a/xc5B3aQjSDU3ErUjyi2oAYUvG#shipthis-col120row32)
 
 #### Help Output
 
-```
+```bash
 USAGE
   $ shipthis game ios app create [-q] [-g <value>] [-n <value>] [-b <value>] [-f]
 
@@ -31,15 +58,25 @@ EXAMPLES
   $ shipthis game ios app create
 ```
 
-### game ios app status
+### `game ios app status`
 
 #### Description
 
-Shows the Game iOS App status. 
+Shows the Game iOS App status. The output will tell you if you need to run the
+create command or sync command.
+
+- If the App does not exist in the Apple Developer Portal then you should run the
+ `shipthis game ios app create` command
+- If you have updated your **export_presets.cfg** file with new capabilities then
+ you should run the `shipthis game ios app sync` command.
+
+#### Example
+
+[![asciicast](https://asciinema.org/a/XbQ1iKf1W021xOF5hupAAadhA.svg)](https://asciinema.org/a/XbQ1iKf1W021xOF5hupAAadhA#shipthis-col120row32)
 
 #### Help Output
 
-```
+```bash
 USAGE
   $ shipthis game ios app status [-g <value>]
 
@@ -53,15 +90,38 @@ EXAMPLES
   $ shipthis game ios app status
 ```
 
-### game ios app sync
+### `game ios app sync`
 
 #### Description
 
 Synchronies the Apple App &#34;BundleId&#34; with the capabilities from the local project.
 
+This command will read your **export_presets.cfg** file and determine which capabilities
+to enable in the Apple Developer Portal.
+
+Currently, only the following permissions are supported:
+
+- **Access WiFi**
+- **Push Notifications**
+
+:::warning
+
+If your game uses other capabilities or if you are using plugins to enable certain
+features such as **GPS** or **file access**, please get in touch so that we can work with you.
+
+**ShipThis is still in beta and we need your help to improve it.**
+
+:::
+
+:::tip
+You do not need to have an **export_presets.cfg** file in your game directory.
+ShipThis will use default values for this file if it does not exist.
+:::
+
+
 #### Help Output
 
-```
+```bash
 USAGE
   $ shipthis game ios app sync [-q] [-g <value>] [-f]
 

package/docs/game/ios.md

@@ -1,7 +1,8 @@
 # Topic: `game ios`
 
-Commands in the Game iOS topic are prefixed `shipthis game ios`. They relate to
-managing the iOS platform configuration for the game in the current directory.
+Commands in the `game ios` topic are prefixed `shipthis game ios`. They relate to
+managing the iOS platform configuration for a specific game (generally in the
+currently directory).
 
 :::tip Info
 You will need to be authenticated against ShipThis and Apple before you can use

package/docs/game/job.md

@@ -1,12 +1,10 @@
 # Topic: `game job`
 
-Commands related to jobs for a specific game
-
+Commands in the `game job` topic are prefixed `shipthis game job`. They relate to jobs for a specific game (generally in the currently directory).
 
 ## Commands
 
-
-### game job list
+### `game job list`
 
 #### Description
 
@@ -36,7 +34,7 @@ EXAMPLES
   $ shipthis game job list --gameId 0c179fc4
 ```
 
-### game job status
+### `game job status`
 
 #### Description
 

package/oclif.manifest.json

@@ -514,10 +514,10 @@
         "wizard.js"
       ]
     },
-    "apple:apiKey:create": {
+    "apple:certificate:create": {
       "aliases": [],
       "args": {},
-      "description": "Creates an App Store Connect API Key in your Apple Developer account.\nSaves the private key in your ShipThis account.",
+      "description": "Creates an iOS Distribution Certificate in your Apple Developer account.\nSaves the certificate with the private key to your ShipThis account",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --force"
@@ -539,7 +539,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:apiKey:create",
+      "id": "apple:certificate:create",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -549,11 +549,11 @@
         "dist",
         "commands",
         "apple",
-        "apiKey",
+        "certificate",
         "create.js"
       ]
     },
-    "apple:apiKey:export": {
+    "apple:certificate:export": {
       "aliases": [],
       "args": {
         "file": {
@@ -562,9 +562,9 @@
           "required": true
         }
       },
-      "description": "Saves the current App Store Connect API Key to a ZIP file",
+      "description": "Saves the current Apple Distribution Certificate to a ZIP file.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> userApiKey.zip"
+        "<%= config.bin %> <%= command.id %> userCert.zip"
       ],
       "flags": {
         "force": {
@@ -577,7 +577,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:apiKey:export",
+      "id": "apple:certificate:export",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -588,11 +588,11 @@
         "dist",
         "commands",
         "apple",
-        "apiKey",
+        "certificate",
         "export.js"
       ]
     },
-    "apple:apiKey:import": {
+    "apple:certificate:import": {
       "aliases": [],
       "args": {
         "file": {
@@ -601,9 +601,9 @@
           "required": true
         }
       },
-      "description": "Imports an App Store Connect API Key ZIP file into your ShipThis account",
+      "description": "Imports an iOS Distribution Certificate to your ShipThis account",
       "examples": [
-        "<%= config.bin %> <%= command.id %> userApiKey.zip"
+        "<%= config.bin %> <%= command.id %> userCert.zip"
       ],
       "flags": {
         "force": {
@@ -615,7 +615,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:apiKey:import",
+      "id": "apple:certificate:import",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -626,14 +626,14 @@
         "dist",
         "commands",
         "apple",
-        "apiKey",
+        "certificate",
         "import.js"
       ]
     },
-    "apple:apiKey:status": {
+    "apple:certificate:status": {
       "aliases": [],
       "args": {},
-      "description": "Displays the status of App Store Connect API Keys in your Apple and ShipThis accounts.\nThis API key is used to automatically publish your games to the App Store.",
+      "description": "Displays the status of the iOS Distribution certificates in your Apple and ShipThis accounts.\nThese are used to sign all of your iOS apps.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --noAppleAuth"
@@ -648,7 +648,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:apiKey:status",
+      "id": "apple:certificate:status",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -659,14 +659,14 @@
         "dist",
         "commands",
         "apple",
-        "apiKey",
+        "certificate",
         "status.js"
       ]
     },
-    "apple:certificate:create": {
+    "apple:apiKey:create": {
       "aliases": [],
       "args": {},
-      "description": "Creates an iOS Distribution Certificate in your Apple Developer account.\nSaves the certificate with the private key to your ShipThis account",
+      "description": "Creates an App Store Connect API Key in your Apple Developer account.\nSaves the private key in your ShipThis account.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --force"
@@ -688,7 +688,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:certificate:create",
+      "id": "apple:apiKey:create",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -698,11 +698,11 @@
         "dist",
         "commands",
         "apple",
-        "certificate",
+        "apiKey",
         "create.js"
       ]
     },
-    "apple:certificate:export": {
+    "apple:apiKey:export": {
       "aliases": [],
       "args": {
         "file": {
@@ -711,9 +711,9 @@
           "required": true
         }
       },
-      "description": "Saves the current Apple Distribution Certificate to a ZIP file.",
+      "description": "Saves the current App Store Connect API Key to a ZIP file",
       "examples": [
-        "<%= config.bin %> <%= command.id %> userCert.zip"
+        "<%= config.bin %> <%= command.id %> userApiKey.zip"
       ],
       "flags": {
         "force": {
@@ -726,7 +726,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:certificate:export",
+      "id": "apple:apiKey:export",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -737,11 +737,11 @@
         "dist",
         "commands",
         "apple",
-        "certificate",
+        "apiKey",
         "export.js"
       ]
     },
-    "apple:certificate:import": {
+    "apple:apiKey:import": {
       "aliases": [],
       "args": {
         "file": {
@@ -750,9 +750,9 @@
           "required": true
         }
       },
-      "description": "Imports an iOS Distribution Certificate to your ShipThis account",
+      "description": "Imports an App Store Connect API Key ZIP file into your ShipThis account",
       "examples": [
-        "<%= config.bin %> <%= command.id %> userCert.zip"
+        "<%= config.bin %> <%= command.id %> userApiKey.zip"
       ],
       "flags": {
         "force": {
@@ -764,7 +764,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:certificate:import",
+      "id": "apple:apiKey:import",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -775,14 +775,14 @@
         "dist",
         "commands",
         "apple",
-        "certificate",
+        "apiKey",
         "import.js"
       ]
     },
-    "apple:certificate:status": {
+    "apple:apiKey:status": {
       "aliases": [],
       "args": {},
-      "description": "Displays the status of the iOS Distribution certificates in your Apple and ShipThis accounts.\nThese are used to sign all of your iOS apps.",
+      "description": "Displays the status of App Store Connect API Keys in your Apple and ShipThis accounts.\nThis API key is used to automatically publish your games to the App Store.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --noAppleAuth"
@@ -797,7 +797,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apple:certificate:status",
+      "id": "apple:apiKey:status",
       "pluginAlias": "shipthis",
       "pluginName": "shipthis",
       "pluginType": "core",
@@ -808,7 +808,7 @@
         "dist",
         "commands",
         "apple",
-        "certificate",
+        "apiKey",
         "status.js"
       ]
     },
@@ -1508,5 +1508,5 @@
       ]
     }
   },
-  "version": "0.0.32"
+  "version": "0.0.33"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "shipthis",
-  "description": "Game Shipping Tool",
-  "version": "0.0.32",
+  "description": "A command line tool which manages releasing your Godot games to the iOS App Store.",
+  "version": "0.0.33",
   "author": "Hello Invent Ltd",
   "bin": {
     "shipthis": "./bin/run.js"
@@ -146,10 +146,10 @@
         "description": "Commands related to App Store Connect API Keys"
       },
       "apple:certificate": {
-        "description": "Commands related to App Store Certificates"
+        "description": "Commands related to iOS Distribution Certificates"
       },
       "game": {
-        "description": "Commands related to Game Management"
+        "description": "Commands related to configuring a specific game"
       },
       "game:build": {
         "description": "Commands related to builds for a specific game"
@@ -158,10 +158,10 @@
         "description": "Commands related to the iOS platform for a specific game"
       },
       "game:ios:app": {
-        "description": "Commands related to the App Store App for a specific game"
+        "description": "Commands related to the App Store App and BundleId for a specific game"
       },
       "game:ios:profile": {
-        "description": "Commands related to the App Store Provisioning Profiles for this Game"
+        "description": "Commands related to the App Store Mobile Provisioning Profiles for a specific game"
       },
       "game:job": {
         "description": "Commands related to jobs for a specific game"