🎉 Welcome to the Mobify DevCenter, our new home for v2.0 documentation and developer resources! (For now, the site is desktop-only.) Switch to old site
close
Mobify DevCenter
DocumentationAPI & SDK ReferenceHow-To Guides
search_icon_focus

Version History

Introduction

Mobify releases a new version of progressive-web-sdk every six weeks, including new features, enhancements to the SDK and scaffold, bug fixes, security patches, and key product documentation. To facilitate smooth upgrades for our partners and customers, releases are designed to incrementally improve the Mobify Platform, rather than introducing large breaking changes.

Improvements to our backend infrastructure are done outside of the product release process, in a system of continuous improvement. As a result, they’re not versioned. Examples include our Application Delivery Network and Mobify Cloud.

We recommend staying up to date with the latest Mobify Platform version, to access the latest features, patches, and bug fixes. To find a detailed summary of each release, check out our Release Notes.

Mobify Platform repository structure

Prior to March 2019, the packages Mobify publishes to NPM used an independent versioning scheme. That meant, for example, that a Mobify Platform release may have included version 1.2.3 of the progressive-web-sdk and version 3.2.1 of @mobify/commerce-integrations.

In March 2019 we switched to a synchronized versioning scheme, which makes it easier to understand which package versions were released together, and have been tested to work together by Mobify. If you’re upgrading packages in your project we recommend updating all Mobify packages together, to the same version number.

The following packages have used synchronized version numbers since version 1.11:

  • progressive-web-sdk
  • @mobify/commerce-integrations
  • @mobify/documentation-theme

Checking your Mobify Platform version number

There are two ways to look up your version of the Mobify Platform.

For one, you can find your progressive-web-sdk version inside the package.json file, which is found under your project’s root folder. For projects operating on version 1.10 or lower, the package.json file will show the versions for each library.

Tag-loaded and server-side rendered apps

Depending on your project, there are two different approaches to creating an application using the Mobify Platform: tag-loaded and server-side rendered.

Server-side rendered apps

Introduced in November 2018, Mobify’s server-side rendering is a technique for rendering what would normally be a client-side only React application on the server and sending a fully-rendered page to the client. Once on the client, the browser then loads the app’s Javascript code which takes over all subsequent rendering. These applications can be crawled by search engines, including by crawlers that don’t execute Javascript code. Another benefit is better perceived performance – users can immediately see the server-side rendered page without waiting for Javascript to load on the client before the first page render.

To learn more about server-side rendered PWAs, visit our documentation on server-side rendering.

Tag-loaded apps

The Mobify tag is Mobify’s early technique for building applications, introduced in 2011. It’s a snippet of HTML and JavaScript which loads an app, typically a PWA, into an existing web page. If you’re building or maintaining an app that renders only on the client-side without making use of Mobify’s server-side rendering, you’ll be working on a tag-loaded project using the Mobify tag.

Milestones in Mobify Platform versions

The following list summarizes major technical milestones in Mobify’s Progressive Web SDK. For a full list of changes, visit our Release Notes. Typically, we find that partner developers are most interested in knowing their version for the project scaffold (project starting point), and knowing their version for our Commerce and Analytics Integrations SDKs.

2019

TechnologyWhat is it?Release DateApplicable Versions
Node Environment* Server-Side Rendered ApplicationsAn update to the Server-Side Rendering architecture to use Node.js and Express.js, instead of the browser-like JSDOM environment.September 26, 2019v 1.13.0 and later
Mobify Cloud API: Target ManagementAn API for partner and customer developers to manage their own deployment targets.July 2, 2019v1.11.0 and later
Synchronized versioningSince July 2019, all Mobify SDKs are released on the same schedule with synchronized version numbers. Previous to this change, those version numbers would have been different for each SDK.July 2, 2019v1.11.0 and later
Analytics IntegrationsMobify’s API to integrate analytics services. Replaces the Analytics Manager and is intended to give developers more control over their analytics implementation.July 2, 2019v1.11.0 and later
Documentation site redesignNew documentation site look and feel.March 28, 2019v1.9.0 and later
New project starting pointGenerated projects come with a starting point “scaffold”, essentially a template with some of the foundational PWA Components already implemented. Note that project starting points are not released as part of the product release process.January 10, 2019v1.0.4-alpha.0 and later

*Mobify’s original November 2018 release of server-side rendering used a “browser-like” environment, enabled by JSDOM. Later, the implementation went through a significant update in November 2019 to match the more conventional Node.js and Express.js implementation which is used by the React community. To learn more, read our Server-Side Rendering documentation.

2018

TechnologyWhat is it?Release DateApplicable Versions
Browser-Like Environment* Server-Side Rendered ApplicationsServer-side rendering architecture, enabling Mobify’s fastest applications to date.November 15, 2018v 1.6.0 to v 1.13.0, inclusive
Commerce IntegrationsAPI to integrate ecommerce backends. Replaces the Integration Manager.September 27, 2018v1.0.0 and later
Performance ManagerAn SDK tool which allows partner and customer developers to control and configure features that affect PWA performance.August 16, 2018v1.4.0 and later

*Mobify’s original November 2018 release of server-side rendering used a “browser-like” environment, enabled by JSDOM. Later, the implementation went through a significant update in November 2019 to match the more conventional Node.js and Express.js implementation which is used by the React community. To learn more, read our Server-Side Rendering documentation.

2017

TechnologyWhat is it?Release DateApplicable Versions
Integration ManagerAPI to integrate ecommerce backends. (Replaced in 2018 by Commerce Integrations.)June 22, 2017v0.15.0 to v1.4.0 inclusive
Mobify UI KitA ready-to-use collection of Sketch design files that pair with Mobify’s SDK Components to build ecommerce pages.May 25, 2017v0.15.0 and later
Analytics ManagerAPI to integrate analytics services. (Replaced in 2019 by Analytics Integrations.)May 24, 2017v0.15.0 to v1.10.0 inclusive

2016

TechnologyWhat is it?Release DateApplicable Versions
Progressive Web SDKMobify’s core Software Development Kit. Includes a set of components and utilities for building performant PWAs.July 28, 2016v0.0.1 and later

Prior to 2016

TechnologyWhat is it?Release DateApplicable Versions
Mobify CloudCommand line interface and backend infrastructure to manage the deployment of apps on the Mobify Platform.2012v0.0.1 and later. Note that Mobify Cloud is released continuously.
Mobify TagA way of loading PWAs through a snippet of HTML and JavaScript, which loads the PWA into an existing web page. (Replaced in 2018 by Server-side rendered Progressive Web Apps (PWAs).)2011v 0.0.1 and later.