Showcase enables you to pre-curate your content into an interactive 'app' that can be navigated on the touch screen. Such apps are usually configured and supplied to you, however extending the setup and managing the content is simple and flexible.
This guide covers content management for Showcase apps that are file system based. This means that the organisation of content in the app folder structure dictates how content is presented in the app.
This guide covers some of the basics of the folder structure to control how the tab bar is structured.
Example file structure
Your Showcase app is configured to load all content from a folder structure, called the workspaces folder. Each sub-folder in this structure creates a tab in the tab navigation bar at the bottom of the screen. You can drop your content into these folders, as well as configure the tab to display content in a particular way.
As an example, a workspaces folder may have the following (minimal) example structure. The app will have 7 tabs (Welcome, XV, BRZ, WRX, Forester, Contact/Find Out More), each with a custom icon. The XV, BRZ and WRX all will have the default content layout (see next section), while the Welcome, Forester and Find Out More tabs have custom layouts (specified through a _layout.xml file). For the default content layouts, any files found in that folder (not beginning with a '_') will be displayed scattered in the middle of the screen.
Note: Whether you app uses custom icon images, or just uses the name of the folder as a text label, depends on the existing app configuration.
Subaru app example workspaces structure
Subaru.capp/workspaces:
1_Welcome
2_XV
3_BRZ
4_WRX
6_Forester
7_FindOutMore
Subaru.capp/workspaces/1_Welcome:
_layout.xml
_off_icon.png
_on_icon.png
_video.mp4 (single introduction video, laid-out in the centre of the screen)
Subaru.capp/workspaces/2_XV:
_off_icon.png
_on_icon.png
<files>... (e.g. brochure.pdf, tour.mp4, productshot.jpg)
Subaru.capp/workspaces/3_BRZ:
_off_icon.png
_on_icon.png
<files>... (e.g. brochure.pdf, tour.mp4, productshot.jpg)
Subaru.capp/workspaces/4_WRX:
_off_icon.png
_on_icon.png
<files>... (e.g. brochure.pdf, tour.mp4, productshot.jpg)
Subaru.capp/workspaces/6_Forester:
_gallery/
_layout.xml
_off_icon.png
_on_icon.png
Subaru.capp/workspaces/6_Forester/_gallery:
<files>... (e.g. brochure.pdf, tour.mp4, productshot.jpg)
Subaru.capp/workspaces/7_FindOutMore:
_layout.xml
_off_icon.png
_on_icon.png
The following table describes the role of the special files that may be added to the tab folders.
| Filename | Description | Required? |
| _on_icon.png | Image file for the tab button, for the selected/on state | Yes, unless text labels enabled |
| _off_icon.png | Image file for the tab button, for the deselected/off state | Yes, unless text labels enabled |
| _icon.png | Image file for the tab button, displayed for both the selected/on and deselected/off state | No |
| _layout.xml (or anything in the folder with .xml extension) | XML file describing which objects to display on the tab (for files/resources that haven't been laid out automatically). See the XML layout guide for more information. | Optional |
| _background.* | Background image or video for the tab (e.g. a PNG, JPG or MP4 file). Overrides the default background image when selecting the tab. | Optional |
| _datawall.* | Image or other file type (e.g. video) that should be automatically 'flicked' to connected Viewer screens when selecting the tab. | Optional |
| _label.txt | A text label for tab button, overriding the label automatically derived from the folder name. | Optional |
You can also add sub-folders to create sub-tabs in a nested hierarchy on the tab bar.
Tab Ordering and Hidden Tabs
The ordering of tabs is based on the name of each folder. You can use a number prefix on each folder to easily control the order of the tabs. If you are using automatic labels, derived from the folder name, the number prefix will be ignored. For example, naming a folder 1_Home will result in the tab being labelled Home.
You can also prevent a tab from appearing in the navigation bar by giving it a prefix of 99_ - for example '99_Hidden Menu'. This is useful if your app defaults to a specific tab, or has custom buttons, so that you can switch to that tab without it being displayed in the tab bar.
Content Layouts on Tabs
Now that we've covered the basics of the folder structure, please refer to the tab layouts guides for details on how to control positioning of content.