Writing a spec document for a mobile app

Writing a spec document for a mobile app does not differ much from writing a website spec document. Here are at minimum the different aspects you will have to tackle.

  1. Your client information.
  2. The needs of your client.
  3. The audience your mobile app will target.
  4. The text content to include within your app.
  5. The features which need to be included in your app.
  6. The graphical part.
  7. The law aspect.
  8. Business model.
  9. How the app will be advertised.
  10. The resources allocated to the project.

Here are below examples of answers for each category.

1 - Your client information

Your client has physical stores.

2 - Needs of your client

She/he would like to know what people are thinking about their store without bothering them. That's why she/he would like to have a tablet available at the exit gate of their store where visitors could rate their experience exactly like in airport or public places such as restrooms.

3 - The audience your mobile app will target

The mobile app will target the consumers of the store. It goes from a very young audience to elder people.

4 - The text to include within your mobile app

The app will be composed of two screens.

The home screen with the following question "How would you rate your global experience today?" showing the different smiley faces.

Each smiley is nothing more than a .png file:

  • very-bad.png
  • bad.png
  • ok.png
  • good.png
  • very-good.png

When people will select a smiley face, they will be redirected to a results screen saying, "Thank for your feedback and your visit". And after 5 seconds users will be redirected to the home screen.

The home screen will looks like this:


the results screen will look like this:


5 - The features to include within the app

The measurement of the values will be done with Matomo Analytics, an analytics solution. The idea is to record the values pushed by the users.

The app is designed in order to always stay active and the device will always be electrically plugged.

The app will be composed as follow for the home screen:

  • The app is set in a landscape mode.
  • There is a title at the middle of the home screen app.
  • There are 5 images which are set at the middle of the app just below the title.
  • Each image is a button which is redirecting the user to the results screen.

The results screen app is composed as follow:

  • There is a title at the middle of the screen.
  • After 5 seconds, the user is redirected to the home screen.
6 - The graphical part

Except for the smileys, there are nothing to do here. Smileys will be designed with Inkscape.

7 - The law aspect
This app is not designed to be downloaded by others, so nothing to take care of here.

8 - Business model

Not a money maker project. This idea is just to get the feedback from users to improve an in-store experience.

9 - How the app will be advertised
The app is designed in order to self-advertised itself at the end of the visit of each person within the store.

10 - The resources allocated to the project
No budget for this project has to be defined. You just need to play with the following three technologies:

  • CMS.
  • Hybrid technology.
  • Native Android.

Last modified: Thursday, 23 January 2020, 1:33 PM