Inserting a WebApp in Amazon App Store

Amazon Appstore is an Android MarketPlace. But Amazon now accept also web apps.
I explain how to submit your web app in the Amazon App Store and what rules must comply with the web app, to be accepted and to be included in the marketplace.


Rules and Best Practictes

To be included in the App Store, the web app must pass a quality test performed by Amazon Team.
Amazon recommends that your web app respect these rules and best practices, for pass quality test:

  • it must have a good UX that does not cause confusion to the user
  • it must not contain bugs, crashes or other defects
  • for every action performed by user, there must be a visual feedback
  • it must not contain distorted images, misaligned text or unreadable text
  • the text in web app must be grammatically correct
  • it must fill all screen area in Kindle Fire device
  • it must not open external browser windows
  • if your web app uses only portrait view, then you must insert a warning message if the webapp is in landscape position, likewise for landscape view.
  • most Android devices view a visual feedback when the users tap web links. Disable it with this code:
    -webkit-tap-highlight-color: rbga(255, 255, 255, 0);
    -webkit-user-select: none;
  • it must fill all screen
  • use Typed Arrays instead JS Arrays, in Javascript
  • use for loop instead for-in loop, in Javascript
  • use local variables o singleton instead global variables, in Javascript
  • use short and modular methods, in Javascript


Test your web app

Before sending the web app to Amazon, you need to test it on an Android Device. To do this, you must follow these steps:

  1. Download the Amazon AppStore from or follow these instructions from Amazon Website
  2. Open Amazon AppStore and sign in (or sign up if you’re not registered)
  3. Search and download “Web App Tester”
  4. Open Web App Tester
  5. Insert your webapp URL in textfield and click “Save”
  6. Click “Android Web View”
  7. Test your webapp entirely


Manifest File

If your web app works, you must create a MANIFEST file for your web app.
Insert the manifest in root path of your webapp.
The Manifest file can contain these fields:

  • verification_key: Amazon gives the verification ID to verify your ownership of app. This field is required
  • verification_key: this is the path of webapp start page. It must be on same domain.
  • permissions: this is required field, if you want use this Amazon features:
    • iap: for allowing in-app purchase
    • geolocation: for allowing geolocalization
    • auth: for allowing auth

Warning: if your webapp use geolocation, iap or auth provided by Amazon API, then you must use SSL protocol.

This is an example of a Manifest file:

    "verification_key": "1234567890",
    "launch_path": "index.html",
    "permissions": [

    "type": "web",
    "version": "0.1a",
    "last_update": "2013-11-15 20:18:00-0100",
    "created_by": "aureliomerenda"


Submit the web app

When I have done Manifest file, you can submit your webaapp on Amazon Appstore.
Sign in on Developer Panel, complete your profile and create a new web app project.
You will need to enter webapp informations: long and short descriptions, countries, icons and screenshots.

There are the states of your submitted web app:

  1. SUBMITTED: your web app was submitted
  2. REVIEW: the Amazon team is testing your web app
  3. PENDING: if the Amazon team find a bug or a problem, it notifies you. When you solve the bug, you must report it to Amazon to continue quality test
  4. APPROVED: your web app has passed the test
  5. LIVE: your web app is on Amazon Appstore

Aurelio Merenda

I live in Florence (Italy). I graduated in IT in 2010, I work as Front End Developer in Buongiorno, a NTT Docomo Group company. I specialize in Javascript & AngularJS. I like photography, movies and cats.