Skip to content

Presentation File Structure

Ethan Lin edited this page Feb 24, 2026 · 1 revision

Storybook Plus file structure diagram

SBPLUS APP folder

The SBPLUS APP folder contains all core scripts for Storybook Plus.

  • It can be centralized on a server so every presentation does not need its own copy.
  • It also contains a manifest JSON file that stores global configuration/settings for presentations referencing the centralized scripts.

If SBPLUS APP is not centralized:

  • Each presentation needs its own copy of the scripts folder and an index.html in the root.
  • URLs in index.html must correctly reference the local SBPLUS APP copy.

Required folders/files:

  • assets/
    • Contains the XML data file and media for the presentation.
    • assets/sbplus.xml is required and holds the context/content of the presentation.
  • pages/ (required)
    • Holds the image for each page/slide.

Optional folders (depending on content):

  • audio/ (required if audio is used)
  • video/ (required if local video is used)
  • images/ (optional; used for quiz images if needed)
  • html/ (used for HTML page type content)

Downloadable files:

  • PDF/MP4/MP3/ZIP may exist in the root as downloadable files (if available).

Centralized vs local assets (author + splash)

Author picture:

  • Can be centralized on a server with proper configuration in the manifest and XML.
  • If a local author image exists in the assets directory, it overrides the centralized copy.
  • Author photo filename is specified in the XML.

Splash image:

  • Can also be centralized.
  • If a local splash image exists in assets with the same name as the configured value (or default name splash), it overrides the centralized image.

Clone this wiki locally