V1.23.0

This is a long-overdue release that updates Cascade to the version that corresponds to the Summer 2022 release of ArcGIS Online. Most importantly, it updates Cascade's Identity Management to be in line with current ArcGIS Online and Enterprise systems. Versions before this might not authenticate correctly, and some content will not load.

Note that, as of Fall 2021, Cascade is in "Extended Support" in ArcGIS Online and "Mature Support" in Enterprise. Thus we would suggest that users look toward creating new stories in ArcGIS StoryMaps.

V1.9.1

This release includes minor features, enhancements, and bugfixes.

New Feature

• Audio uploading enabled

Fixes

• Some issues when duplicating immersive views with maps in builder should be fixed

Technical Changes

• Updated the ArcGIS API for JavaScript versions to 3.26 and 4.9

V1.8.3

This release includes a few major features, enhancements, and bugfixes.

Major new features

• Tall narrative panels
• Enhanced accessibility with alt text and aria labels
• Embed bar
• Vimeo and YouTube videos support start and end time parameters

See this story map and this blog post for more details on these exciting new features.

Enhancements/Updates

• Pre-populate Unsplash captions with source info
• Increase search results for Unsplash photos
• Webpage default interaction setting changed from Enabled to Button to Enable
• Developer-only webpage interaction mode of mouseover added (blog post with details coming soon)

Fixes

• Long immersive sections have matching background, narrative panels on mobile
• Narrative panel videos do not show the appearance media config tab
• Narrative panel media config panel sits above other media controls
• Solved syntax error when running viewer with unminified code
• Third party API keys moved to unminified app/config.js file
• YouTube videos repeat in immersive backgrounds
• Heatmaps and uploaded logos display correctly in print version
• Some CSS and styling tweaks

Technical Changes

• Updated the ArcGIS API for JavaScript versions to 3.25 and 4.8
• Added language support for Hungarian, Catalan

V1.7.2

This release includes a few major features, enhancements, and bugfixes, as well as some breaking changes.

Major new features

• Firefox support added for builder
• Printing
• In-app map editing/creating

See this story map for more details on these exciting new features.

Enhancements/Updates

• Immersive section videos are muted by default (with button to unmute if the author has not set the video to always be muted)
• HTTP content scanning and fixing (checks story for HTTP webpages, images, videos, audio)
• HTTPS web security banner added (builder only)
• Media have gray outline instead of gray background when loading

Fixes

• Immersive videos autoplay on Mac Safari (muted by default)
• Long URLs in credits are wrapped
• Media config panel tab error and warning indicators restored
• Image fit/fill config UI alignment fixed
• ArcGIS API for JavaScript URL paths made static again

Technical Changes

• Updated the ArcGIS API for JavaScript versions to 3.24 and 4.7

Breaking Changes 🚨 🚨

Some changes were made in the app structure which may affect you if you've modified any of the following files and merge in these newest changes. If you have not added/modified code in any of the following files, merging shouldn't present any issues for you.

File/folder locations moved

The src/app/storymaps/common directory was removed and its files/folders have been migrated to other directories where they are better suited. If you have added/modified code in these files and merge in these changes, your modifications will be preserved in the file at its new location.

Specifically, these files/folders have moved:

• common/builder/ files/folders moved inside src/app/storymaps/tpl/builder/
• common/ui/ files/folders moved inside src/app/storymaps/tpl/view/ui/
• common/utils/ files/folders moved inside src/app/storymaps/tpl/utils/
• common/core.css|js|less moved inside src/app/storymaps/tpl/core/
• common/common-variables.less file moved inside src/app/storymaps/tpl/view/ui/common-variables.less
• common/_resources/fonts/ files/folders moved inside src/resources/fonts/
• common/_resources/icons/builder-share.png|warning-icon.png files moved inside src/resources/tpl/viewer/icons/
• common/_resources/icons/media-picker/ folder moved inside src/resources/tpl/builder/icons/
• common/_resources/nls/ contents of files moved to be inside src/resources/tpl/builder|viewer/nls/ files

File extension changed, File deleted/re-added

Unlike the other file moves mentioned, a merge conflict will result if you have made any modifications to these files; read on for details.

The file Common.js, located at src/app/storymaps/tpl/view/section/, has been changed to the .jsx file extension (it's now Common.jsx). It is still in the same directory.

The filebrowseToggle.css, located at src/app/storymaps/common/builder/mediaPicker/browseToggle/, has been deleted in that directory and re-added at src/app/storymaps/tpl/builder/mediaPicker/browseToggle/.

If you have added/modified code in Common.js or browseToggle.css and merge in these changes, you will have a merge conflict. Your original Common.js or browseToggle.css file will keep your modifications and will still be in the project, and there will be a new Common.jsx or browseToggle.css file at the specified location. You will need to manually apply your changes from the original Common.js or browseToggle.css file into the new Common.jsx or browseToggle.css file, delete the original Common.js or browseToggle.css file, and commit in order to resolve the merge conflict. Note that Common.js uses only ES5 syntax, while Common.jsx uses ES6 syntax.

Please open an issue on this repo if you experience any difficulties upgrading.

V1.6.2

This is a minor release that improves the appearance of Cascade stories and includes several bug fixes.

Enhancements

• Improved readability of text in narrative sections, especially on very wide screens
• Enhanced appearance of credits section
• "Fade slow" transition is now slower
• Title overlay for YouTube videos is hidden for cleaner look and to eliminate conflict with cover logo
• Story overview panel now reflects the current theme
• Captions on low-res images are constrained to the proper width

Fixes

• Addressed video layout issue caused by a change in the Vimeo embeddable player that prevented videos from filling the page at wide browser aspect ratios
• Matched all background colors to their theme
• Images in stories shared to the portal or group are no longer broken (ArcGIS Enterprise 10.6)
• Eliminated a situation in which hyperlinks gain a background color
• Addressed several localization issues

Technical

• Updated to JSAPI 4.6 and 3.23
• Changed how JSAPI URLs are generated
• Added Slovenian language support

V1.5.1

Fixes

• Longer entries on the left side of the credits section now wrap as expected
• More than 50 uploaded images are now visible in media picker
• Width limit on uploading GIFs has been removed (file size limit is still 10MB).
• "Explore" button no longer shown on mobile if interaction has been disabled.
• Fixed an issue with pop-up configuration
• An issue with cookies has been addressed that eliminates several unexpected login prompts and redirect loops (including BUG-000107511).
• Several issues with localization have been addressed
• Improved warning messages for how media will behave on mobile devices.

Other changes

• Updated Twitter hashtag to #StoryMaps
• Updated to ArcGIS API for JavaScript v 3.22 and 4.5

V1.4.2

Major new features

• Add alternate images to scenes, maps, videos, apps, and web pages to improve how stories look on mobile devices. Content that is not supported on mobile devices or is likely to not work well on mobile triggers a warning
• Add audio to a story by linking to a file on the web. MP3, WAV, and M4A formats are supported.
• Tall images can be used in a story without cropping
• Choose from a new dark theme or the original light theme
• Choose a font for the story titles and body. Four font options are available, two serif and two sans serif

Enhancements/updates

• Added support for new click-through link property of Shared Themes
• Sizing of linked content is improved. Cascade builder now honors an <iframe>'s height attribute so you can set the size of your embedded media
• Media fades in when reading stories and media pre-loading is improved.
• Timing of swipe and fade transitions has been improved
• Autoplay mode has been updated to use continuous scrolling
• Style of narrative panels is standardized in Cascade's mobile view for a better, consistent look.
• Color palette options have been improved and selected to work well with light and dark themes
• Many visual enhancements have been made to Cascade builder for clarity and to improve the experience when builder is used in non-English languages
• Accessibility enhancements
  • Readers get a message when JavaScript is not enabled in the browser (via a <noscript> tag)
  • Loading animation now has alt text for screen reader software

Fixes

• When embedded Cascade stories are viewed on an iOS device the reader now sees the cover page and a link that opens the story in a new tab. Previously embedded Cascade stories appeared broken on iOS
• When the same map is used in several views of an immersive section and pop-ups are configured, the story no longer jumps back and forth between pop-ups
• Changing the scroll speed for text panels from slow to fast for slides in an Immersive Section within Story Map Cascade makes all text panels in the other slides disappear (BUG-000105269)
• Credit hyperlink text matches link color in other parts of the story
• Several issues with internationalization have been addressed
• Longer titles look better on iPads and iPhones (font size reduced)

Technical Changes

• Updated ArcGIS API for JavaScript to V3.21 and V4.4
• JSAPI always loads via https to take advantage of http2
• URL shortening now uses a service hosted by Esri

V1.3.3

Bug Fixes:

• Immersive map layer list -- hides when scrolled to new view (when new view is a different map or media)
• Immersive map popups don't get clicked on in other views

V1.3.2

As of this release Story Map Cascade is now out of beta.

Major new features:

• Enhanced image galleries now beautifully arrange photos of any size into a regular layout that supports multiple rows of images.
• Accessibility features have been added including support for screen readers and keyboard navigation
• Cascade has been localized and is now available in all supported languages

Enhancements/updates

• Clicking the title in the header returns to the cover
• You can use your organization's Shared Theme logo, if one has been configured by an administrator
• Improved performance of stories with multiple web scenes
• Web scenes set to show a slide no longer navigate from the initial extent to the slide extent while the scene loads

Fixes

• Fixed several issues related to the map extent not saving when configuring map
• When a map/scene is used in multiple views in the same immersive section, changing that map/scene to another media element no longer changes that map/scene in the other views where it appears
• Popup could be seen in builder but not viewer
• Could not delete an entire block of text if it followed a media element

Technical Changes

• Updated ArcGIS API for JavaScript to V3.20 and V4.3