Everything starts with the creation of a project on the Twixl platform. This article explains the ins and outs of adding a project. 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. We talk about apps when the project is facing the end user.
Projects
When you first log on the Twixl platform, your Projects page is empty. Let's start creating your first project by clicking the '+' icon.
Project Mode
When you add a Twixl Project 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.
When you have created your first project, you will always create a new project from scratch. Then your first page will ask you to select a Project Mode (development or production). The idea is that you start with a Development project and once your Development project has been tested and approved, you can then copy or change this Development project into a Production project so you can start building and distributing your app to app users.
Add new app
Once you have selected a template app or the Project Mode, enter the required information in the Project Details.
- Name*: This is the name of the project on the Twixl platform. This can be different from the name that your app's users will see on their device (which is defined in Build Settings).
- 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.
- Project Icon: You can add an project 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 which is also defined in Build Settings.
- Metadata: You can enter additional information about the Project here.
You can now click 'Save' to store the Project Setup for your first Project on the Twixl platform!
Project Setup
Once your project is created, you can always return to the Project Setup page by:
- Clicking on 'Project Setup' in the Menu bar.
- Opening the 'Project Info' icon (top right in the breadcrumb bar) and clicking on the 'edit' icon.
- On the Home page, selecting the settings icon.
You will now also see these fields:
- App Key: This is a unique Twixl identifier that is asked for when you contact Twixl Support so we can immediately check the project you are working on.
- Storage type: By default this is set to Twixl Storage.
- Storage region: This field indicates the region where your account is stored so you will be able to get faster responses from the Twixl platform.
Optional:
- Allow Users to access this Project: Here you can define which other users can access this project. More info about Managing Users can be found here.