Login

Learning & Support

Documentation

How to migrate from legacy Cell Styles (pre-TP10) to Item Styles

Twixl Support Team Updated: - Created :

    1. About Item Styles

    Since version 10 of Twixl Publisher, we moved from the legacy 'Cell Styles' to the new 'Item Styles'. Item styles offer a lot more possibilities, but the requirement is that your app needs to be built using Twixl Publisher 10 or higher.

    Important: if your Twixl app was built with a version older than TP10, you will need to make sure your app is updated first using the latest release.

    The following table explains the matrix of versions:

    Twixl Platform
    App Version (iOS and/or Android Result in the app
    Cell Styles (you didn’t migrate the app on the Twixl Platform yet).  Version 9.x or lower
    All Cells will be rendered correctly
    Cell Styles (you didn’t migrate the app on the Twixl Platform yet).
    Version 10.x or higher All Cells are backwards compatible and will be rendered correctly. 
    Item Styles (you migrated the app on the Twixl Platform).  Version 9.x or lower No Cells will be visible, because Item Styles can only be rendered in a 10+ version of a Twixl app. 
    Item Styles (you migrated the app on the Twixl Platform).  Version 10.x or higher
    Both converted Cell Styles and new Item Styles will be visible in a 10+ version of a Twixl app. 

    2. How to migrate if your users are on an app built with TP10 or higher ?

    If all the users of your app are on a Twixl version 10 or higher, then you can just go ahead and select 'migrate your app to 'item styles'' on the main page for your app on the platform. You can use the report 'Views by Twixl version' to verify this.

    Once you've done that, you can take advantage of the extra features that are possible when using 'Item Styles'. As always, it is recommended that you plan regular updates of your Twixl app, based on the latest Twixl release, as this guarantees support for newer iOS or Android versions, newer devices, bug fixes, etc.

    3. How to migrate if your users are on an app built with a version older than TP10?

    Make sure you read each step carefully!

    IN SHORT: WHAT'S IMPORTANT:

    • You'll need to be able to serve your content to both versions of your app: version 9.x or lower and version 10+ or higher. This way you can migrate easier and avoid errors.
    • There is one big keyword: testing!

    3.1. Create a copy of your existing app on the Twixl platform

    The first thing to do, is to create a duplicate of your existing app on the Twixl platform:

    1. The new copy will be connected to your version 10+ build of the app. Rename the app, as an internal reminder that this will be the new version of your app. E.g.: add a suffix v17.
    2. The existing copy will continue to serve your version 9 of the app. Rename the app, as an internal reminder that this will be the new version of your app. E.g.: add a suffix v9.

    DEVELOPMENT vs. PRODUCTION

    We strongly advise you to create a Development version first. This will make it easier to test your newly updated app on your own devices first. In your Production app, select 'Copy to Development' to create the new app to test.

    3.2. Migrate the new app on the Twixl Platform to 'item styles'

    In order to use the new Item Styles, you'll need to convert the copied v10+ app on the platform.

    3.3. Adapt your Browse Grids and Item Styles (optional)

    If you want (and if necessary) to make use of the new layout options, you can now adapt the Item Styles. See:

    3.4. Test your app built with the latest version of Twixl Publisher

    As always, testing is the most important thing. You can test your new app as follows:

    3.5. Create your final production build and submit the app

    After testing, it's time to create a final build of your Production App and submit that build to the stores.

    When the update is published and most or all of your users have updated to the latest release, you can delete the old 'cell style' version of your app. You can use the report 'Views by Twixl version' to verify how many users are on the latest version.

    Was this article helpful?

    0 out of 0 found this helpful