App Market Submission Instructions

These are temporary instructions for submitting apps to Sandstorm's new app market. The app market is not officially launched yet, but you can follow these instructions now.

1. Sign up for Keybase

We use PGP and Keybase to verify app authors. Keybase has extensive documentation on how to set up GPG and create your key. See:

https://keybase.io

If you need an invite, ask Kenton or Jade.

Be sure in particular to link your Github and Twitter accounts to your Keybase profile, as they will be displayed in your app listing.

Optionally, you can skip signing up for Keybase. However, your app listing will not be linked to your identity, and people will not have proof that it came from you.

2. Update your app manifest to contain listing metadata

You must extend your package to contain the necessary metadata for the app market.

Here is an example commit updating Etherpad.

Documentation:

• Metadata fields
• Open Source licenses
• Categories/genres

Update: New submissions require shortDescription to be filled in, even though the Etherpad example did not include it. The shortDescription is displayed immediately under each app title in the tile view (front page).

3. Submit your app

Once you've built an SPK, submit it like so:

spk publish mypackage.spk --webkey=https://alpha-api.sandstorm.io#Rs-0TT13YrNSbv7Fiz5K9bBkLaJn3E5TB0PU1GSn1HE

(Note: The --webkey flag will no longer be needed starting with build 0.106, which hasn't been released yet. If you're building Sandstorm from master, you can already skip this flag.)

(Note: If you are developing your app with vagrant-spk, you can publish from inside your Vagrant box by doing vagrant-spk ssh and then adding --keyring /host-dot-sandstorm/sandstorm-keyring to the above spk publish invocation.)

It will then go into the queue for us to review. We'll check that everything looks right. If it does, we'll publish the app, otherwise we'll email you to let you know what needs fixing.