Everything starts with the creation of an app on the Twixl platform. This article explains the ins and outs of adding an application. On the Twixl platform, we refer to apps as 'Projects' and when you login to the Twixl platform, the first thing you will see is a list of all your projects.
Application Type
When you add a Twixl app on the Twixl platform for the first time (in trial mode), you can choose from several "templates" to get you started. For more info about each of these templates, see: Getting Started sample app or Kiosk sample app.
Application Mode
The next thing to select, is the Application Mode. The idea is that you start with a Development App and once your Development App has been tested and approved, you can then copy or change this Development App into a Production App.
Add new app
Once you have selected a template app and the type of app, enter the required information in the Application Details.
- Application Name*: This is the name of the app project on the Twixl platform. This can be different from the name that your app's users will see on their device.
- Bundle Identifier*: This should be a reverse DNS name like com.twixlmedia.appname - only lowercase characters, numbers and dots can be used.
* Both these fields are required before you can start creating a Twixl project.
- Storage Type: By default, this will be Twixl Storage.
- Application Icon: You can add an application icon to make it easier to identify your project in the project list on the Twixl platform. This is different from the icon that will be used to build your app.
- Application Title: You can enter a title here.
- Support e-mail: When users report a problem, their message will be sent to this e-mail address.
- Prompt for App Store Rating: Prompts the user to rate your app in the App Store.
- Blur snapshot in iOS and Android app switcher: If you enable this option, potentially sensitive information in the app switcher screen will automatically be blurred.
- Keep All Data Offline: With this option enabled, an app will be forced to download all available content when starting up for the first time. See this article for more info.
- Sharing on Social Media: When allowing sharing on social media, users can share articles. For more info, see this article.
- Encrypt PDF Files: Enables on-the-fly encryption for PDF content items. That way, PDF files are protected on mobile devices (most relevant on 'open' systems like Android).
- Save reading position in PDF files: allows the user to return to the last visited page in the PDF.
- Externally Managed Content: Enable this when you have an external system that manages the content. This puts the content items and collections of your app in read-only mode on the Twixl platform. For more info, see this article.
- Metered access: Allows you to upload free preview items that users can check for free before they purchase the item. Once this feature is enabled, it cannot be disabled.
- Allow Users to access this Application: Here you can define which other users can access this app. More info about Managing Users can be found here.
Once you have entered and selected these essential settings, save your project by clicking 'Add'.
Once your project is added to the Twixl platform, it will show in the Project list page.
More app settings can then be set via 'App Settings' at the bottom of the left menu.