Skip to main content

Upload Package to Showpad

Note
  • Showpad Apps can not exceed 4GB
  • If your Showpad App will be displayed in the Windows Desktop App, it must be able to run on (non-Chromium) Edge version 18 or above.

Via API​

There following resources are available when uploading your app:

ResourceDescription
UploadAn upload resource is required to upload a .showpad package.

When updating an existing app with a new version, the upload resource should be linked to the existing app.

Once Showpad has completed processing the .showpad package, the upload resource will be linked to both the Showpad App and its versions.
AppA Showpad App is globally unique in Showpad, based on the identifier found in your manifest.json file.

A Showpad App can have multiple versions linked to it.
VersionA single immutable version of an app, linked to a single version of an uploaded .showpad package.
AssignmentEnables a Showpad App to be accessed by customers (organizations). In order to access to your app, an assignment must be created.

An assignment is linked to a specific version and an organization.

You can assign different versions to different customers. Once assigned, the latest assigned version can be installed by the organization.

You can find all the details about these resources in the App Portal API specification.

Upload New App​

  1. Create the upload resource:

     POST /app-portal/v1/uploads
    Content-Type: application/json
     {} // empty json object as body for the POST

    Response Example

    {
      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "contentType": "application/vnd.showpad.app+zip",
      "uploadUrl": "https://my-upload-url",
      "status": "WAITING_FOR_UPLOAD",
      "createdBy": "xxxxx",
      "createdAt": "2023-04-18T07:10:33.461Z",
      "updatedAt": "2023-04-18T07:10:33.461Z"
    }

  2. Next, it's time to add your package to the resource you just created using the uploadUrl and contentType from the response you received:

    PUT {{uploadUrl}}
    Content-Type: {{contentType}}

    // {your .showpad package} as body

    If your upload is successful, you’ll receive an empty response and a 200 Ok status code.

    caution

    After a successful upload, the package still needs to be processed. We highly recommend that you monitor the upload until the status is "ACTIVE".

Congratulations, you’ve uploaded & created a Showpad App!

Monitor Uploads​

You can monitor the upload process and its status with the following code, using the id you received when creating the upload resource as the uploadId:

GET /app-portal/v1/uploads/{{uploadId}}

Response Example

{
  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "contentType": "application/vnd.showpad.app+zip",
  "status": "ACTIVE",
  "createdBy": "xxx",
  "createdAt": "2023-04-18T07:10:33.461Z",
  "updatedAt": "2023-04-18T07:10:33.461Z",
  "app": {
    "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "appKey": "com.showpad.example.app",
    ...
  },
  "version": {
    "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "appId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    ...
  }
}

During processing, the status will be WAITING_FOR_UPLOAD. If the status is:

  • ACTIVE - Your package has processed correctly. The app and version properties are provided. This is where you can retrieve the appId and versionId of your Showpad App.
  • FAILED - Your package has not processed correctly. The error property will contain more details.
tip

The following endpoints can provide more details about your:

  • Showpad App
    • All apps - /app-portal/v1/apps
    • A single app - /app-portal/v1/apps/{{appId}}
  • Showpad App versions
    • All versions - /app-portal/v1/apps/{{appId}}/versions
    • A single version - /app-portal/v1/versions/{{versionId}}

Update App Version​

  1. Create a new package with the same identifier in the manifest.json, but with an increased version (semantic versioning format).

  2. Fetch the appId from the app you want to upload. You can use the /app-portal/v1/apps endpoint for this. Follow the same steps as Upload New App, but use the following body:

    POST /app-portal/v1/uploads
    Content-Type: application/json
     {
      "appId": "{{appId}}"
    }

    This will link the created upload to your specific app. The processing of the upload will fail if the identifier in the manifest does not match the identifier of the provided appId. You can very the update via the Monitor Uploads process.

Via CLI​

Upload App​

The apps upload command enables you to publish your newly created app or its new version to Showpad. This command:

  1. Validates the manifest.json file.
  2. Retrieves the identifier (used as the app key) and version from the manifest.
  3. Checks if an app with the given app key has already been uploaded:
    • If not, the command uploads the app as a new app.
    • If an app with the app key already exists, the command uploads as a new version of the app.

To upload your app with this command, run the following:

npx showpad apps upload {{path/to/file}}

Possible Outcomes​

  • Success - A message is displayed indicating that the app is now active. The message includes AppId and version of uploaded app
  • Failure - The command provides details about the reason for the failure and notifies that the app couldn't be uploaded.

Upload Status​

In some cases, an upload may take longer than usual. The command attempts to check the upload status 10 times. If the upload hasn't completed during this time, the uploadId is displayed, as well as the command to track the upload status.

[showpad] The App has not become active after 10 attempts.
To continue tracking the status of the app upload,
please execute the following command:

 showpad apps status --upload-id 01H1VPZ2ABKDH00NEAWBMCN6HF