Summary :
1- Logon to the generator
2- SmartApp Layout
3- Templates
4- Media Library
5- Building your SmartApp
6- Publishing
With smarty’s unique platform, you can easily create content to be displayed on smartphones (iPhone and Android).
This content we call “SmartApp”, is actually identical to the full apps you normally use on your Smartphone. Associated with each SmartApp is one or more images (the "TRIGGERS") recognized by the smartsy™ application. When this “TRIGGER” IMAGE is recognized, the content associated with it (the SmartApp) is immediately loaded to the Smartphone.
With the SmartApp Generator you will create SmartApps and associated TRIGGERS. As soon as you publish your audience (clients, friends) will immediately see the content you have created by using the smartsy™ application in their phone and using their camera to click on the TRIGGER image. You can always go back to the SmartApp Generator to modify, add to, or delete your content.
The Generator is at its best when you use a browser such as Chrome, Safari or Firefox.
1-LOGON TO THE GENERATOR
Use of Generator is free. To access it the first time you must first register since:
1- The registration will automatically open your personal account so that you can manage:
- Your SmartApps (you can create as many as you like)
- Associated images (TRIGGERS)
- Your media library (images, icons, sounds and videos you download and use in your SmartApps)
2- You are responsible for your content and must accept the terms and conditions before use. Read them carefully as they concern your legal responsibility regarding the content.
2-SMARTAPP LAYOUT
A SmartApp is composed of PAGES that you create with the Generator.
For a SmartApp be valid, it needs at least two pages.
THE 3 AREAS OF THE SMARTAPP SCREEN
The graphics architecture of a PAGE is composed of specific areas:
→On top: HEADER
It measures 320px X 44px exactly: you cannot change the proportions.
It is part of the "COMMON AREAS" used to display:
- Icons and links to your favorite social networks to share your SmartApp (you have 3 icons max)
- At the center, your logo or title as an image
- A small area on the right is reserved to the smartsy icon
→In the center: MAIN PAGE
It measures 320px X 365px
This is the area we call a PAGE in the Generator
This is the area where you will unleash your imagination and build content using the TEMPLATES provided.
→At the bottom: NAVBAR
It measures 320px X 49px exactly. You cannot change the proportions.
It is part of the "COMMON AREAS"
This area used to display the icons you need to navigate within your SmartApp (6 max)
→In the center: MAIN PAGE
The center can be used over its entire surface (320X390px).
It also has two optional fields: the title bar and the option bar.
The title bar: At the top of your PAGE
- It is used to add a title or free text, and can be enriched with a picture
- Its size is configurable. Default height is 46px
- When this bar is activated, the central zone is lowered in proportion to the height you've decided on your title bar.
The option bar: At the bottom of your PAGE
- It is used to publish additional elements of your content: buttons, images, promotions, etc ...
- Its dimension is fixed: 320px X 44px
Now that you know the main areas of your SmartApp, you can create different types of PAGEs based on the TEMPLATES provided.
3-TEMPLATES
Each PAGE of your SmartApp must be based on one of the TEMPLATES provided. You have the choice between 6 different TEMPLATES:
"IMAGE" TEMPLATE
This is the simplest TEMPLATE. It involves inserting a picture in your PAGE.
The image is positioned at the top left.
If you want your image to occupy all the space available it will measure 320px X 365px (or less if you use the option bar and / or title).
"GALLERY" TEMPLATE
This TEMPLATE can display multiple media (images or videos) that will be displayed successively by clicking on arrows or scrolling with the finger on the screen of the Smartphone.
Your images are positioned according to their size either in full screen or centered.
You can insert the optional navigation arrows available to you from the standard elements of the Library (see MEDIA LIBRARY)
"VIDEO" TEMPLATE
This TEMPLATE is to add a video to your PAGE. It has to be in MP4 format.
Video playback tools are automatically integrated into the application.
"AUDIO" TEMPLATE
This TEMPLATE is to add a sound to your PAGE. It has to be in MP3 format.
Audio playback tools are automatically integrated into the application.
"LIST OF LINKS" TEMPLATE
This TEMPLATE allows you to create a list of links menu providing access to different PAGEs of your SmartApp.
The links are formatted according to the usual formats used in smartphones.
Each menu item can be illustrated by an icon or image of your choice.
"WEBVIEW" TEMPLATE
This TEMPLATE is the one that allows you the maximum freedom as it contains a WYSIWYG editor.
You can write text, typographically rich, insert images (jpg or png), internal or external links, etc... as in a normal word processor.
The window is formatted for the Smartphone to make the layout easy.
"DETAILED VIEW” TEMPLATE
This template allows you to add icons over a zone of a picture or a figure to display a contextual overlay content (text and/or multimedia). This additional content is created in a specific editor.
You also have access to source code and therefore, if you know html, you can improve your scripts or include specific behaviors such as iframes (eg : to insert Youtube video embed code, to insert a specific page from a web site (if responsive).
4-MEDIA LIBRARY
The SmartApp Generator has two functional libraries:
1- Standard elements composed of basic icons to use in menus
2- Your personal library that you will gradually enlarge by downloading the images, sounds or videos you want to use in your SmartApp.
With each download, you will be offered different kinds of image formats (depending on the context). You can also resize your images indicating the desired sizes.
We recommend that you prepare your images before you upload them.
The elements of your media library are kept for the life of your SmartApp.
The Generator also has a third library to store the TRIGGER images associated with your specific SmartApp. You are entitled to 5 images per SmartApp. Until you publish your SmartApp you can manage this library by adding or removing associated images.
Once your app is published you would not change anyone of your triggers. Be careful before uploading them to be sure they are the good ones.
5-BUILDING YOUR SMARTAPP
After you have registered and/or logged in, you can start creating your SmartApp.
First, give it a name. This name cannot change as it identifies your SmartApp and partners it with its TRIGGER images.
CREATING PAGES
Create a PAGE by clicking "add a PAGE"
A popup window opens asking you to name this PAGE (provide an easily identifiable name). You are also asked at this stage to choose the TEMPLATE of your PAGE.
As you build your PAGE, you are able to visualize it and see what your audience will see.
Each action on the PAGE automatically records and updates the "side bar" to the left of the screen. This lets you navigate between your PAGEs, display change or them if necessary.
To delete a PAGE, you must click on it in the “side bar” and delete using the "PAGE" menu at the top of your screen.
To order your pages in the side-bar, use the drag & drop function to move the of the page at the right place.
In the “side bar”, each small picture of your PAGE is accompanied by two icons:
- <icon home>: indicates whether this PAGE is the HOME PAGE of your SmartApp. You can choose at any time.
- <icon link>: indicates whether this PAGE is linked to a menu item or to other PAGES. This icon allows easy detection of orphaned PAGES.
You can create as many PAGEs as you like. But do not forget to link them either to a menu items or to internal links or they won’t appear.
There is no "Save" button in the Generator, each action you make is automatically saved. So you do not lose your work. The only exception is the "webview template", when working in the editor, you must "validate" for your changes to take effect.
COMMON AREAS
Select "Change the common areas" allows you to access your HEADER and your NAVBAR.
HEADER
To access the editor of the HEADER, click the + button at the TOP right of the Smartphone.
Use it to:
- Insert icons and links to social networks (3 max) - you have a choice of fifty networks preformatted. Do not forget to include the URL of the PAGE to which you want to point to.
- Insert a logo or image. It must have a maximum height of 44px. Its maximum width is 320px. If you insert both icons of social networks and a centered logo, remember to calculate the width of your logo to avoid unsightly issues. Same for the right part of which is reserved for the smartsy icon.
- Change the image or the background color of the bar.
NAVBAR
To access the NAVBAR, click the + button at the BOTTOM right of the Smartphone.
Use it to:
- Enable or disable the NAVBAR (buttons at the top)
- Insert icons and menu links to your PAGEs.
To add icons, you can use icons stored in the library "standard elements". They correspond to classic icons of Smartphone. You can also choose your own icons (max 35pxx35px - black & white mode, format png)
- You must then give a title (that's the word that appears under the icon in the NAVBAR). Its length is limited to ten characters and depends on the number of active icon.
- You will finally indicate an internal PAGE linked to your icon. Without this indication, the icon will not appear in the NAVBAR simulator.
- You can change the order of your icons with the up and down arrows.
The icon pointing to the home PAGE of your SmartApp must always be in first position.
6-PUBLISHING YOUR SMARTAPP
when you have built all the PAGES of your SmartApp, you can publish it so that everyone immediately sees your work!
First, check
1 - THE SIMULATOR
By clicking "Preview" on the top menu, you activate a Smartphone simulator that replicates as closely as possible the behavior of your SmartApp in real situations. You can verify the links between PAGES, if the videos are working properly, if your layout is correct.
Then:
2 - THE TRIGGER
By clicking on "Tools" then "Image Trigger" on the top menu, you select a window that allows you to upload your TRIGGER images.
These images are important because they are the key to accessing your SmartApp. They must be of good quality, large enough (minimum 400 px square), with good contrast.
You can submit up to 5 TRIGGERS for each SmartApp.
Make sure your images are loaded in the "library".
3- PUBLISH
By clicking on "Publish" on the top menu, you activate the publishing module.
A popup window asks you to verify a number of points and shows orphaned PAGES (those that do not have menu and/or links).
Some PAGEs are called orphan but they may have internal links to your SmartApp. You can ignore this warning if you think that your PAGEs are well linked.
When you enable the publication of your SmartApp, it is immediately online and accessible to your audience.
You can still change, but your changes will be "live". However you cannot change your TRIGGERS.
When a SmartApp is published, a red light is lit next to its title.
When you click Publish or Remove actions take effect after a minimum of 45 seconds. The time needed for our engines to analyze compliance with your TRIGGERS ; it depend of the number of triggers you loaded. The button indicates "Updating”. When the process is over, "publish" button is displayed in the top menu. At the same time, the red LED indicating the publication of your SmartApp is on.


User-guides