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.

    In version 10 of Twixl Publisher, we completely redesigned the way you create and maintain Item Styles. We implemented a lot more possibilities and as a publisher you are able to finetune your designs a lot (!) more than before. But: apps need to be compatible.

    Important: the new Item Styles only work with apps that were built with version 10+ of Twixl Publisher, so you will need to make sure your app is updated first.

    The following table explains the matrix of versions:

    Twixl Distribution Platform
    App Version (iOS and/or Android Result in the app
    Cell Styles (you didn’t migrate the app on the Twixl Distribution Platform yet).  Version 9.x or lower
    All Cells will be rendered correctly
    Cell Styles (you didn’t migrate the app on the Twixl Distribution Platform yet).
    Version 10.x or higher All Cells are backwards compatible and will be rendered correctly. 
    Item Styles (you did migrate the app on the Twixl Distribution 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 Publisher app. 
    Item Styles (you did migrate the app on the Twixl Distribution Platform).  Version 10.x or higher
    Both converted Cell Styles (now Item Styles) and new Item Styles will be visible in a 10+ version of a Twixl Publisher app. 

    2. So what's the best strategy to migrate?

    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.x or higher. The reason is twofold:
      1. Readers/users of your app will not update your app straight away.
      2. This way you can migrate easier and avoid errors.
    • There is one big keyword: testing! Make sure you test all over again.

    2.1. Create a copy of your existing article-based app on the Twixl Distribution Platform

    The first thing to do, is to create a duplicate of your existing article-based app on the Twixl Distribution 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 v10.
    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.

    2.2. Convert the new app on the Twixl Platform

    If you want to make use of the new Item Styles, you'll need to convert the copied v10 app on the platform.

    2.3. Adapt your Browse Grids and Item Styles

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

    2.4. Test your v10 app

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

    2.5. Create your final production build and submit the app

    After testing, it's time to create a final build of your Production App (if necessary, create a Production Copy first on the Twixl Distribution Platform) and submit that build to the stores.

    Was this article helpful?

    0 out of 0 found this helpful