MainStage Card Synopsis
The MainStage card serves as the primary weekly navigation and media hub for the app.
It is designed to organize scripture study, audio guidance, and related weekly resources into a single central interface.
At the top level, MainStage automatically loads the current week based on the app’s calendar logic.
This determines which weekly content package is active, including:
Torah portions
Prophets / Haftarah readings
Gospel readings
Apostolic or Letter readings
associated audio playlists
chapter outlines
optional video resources
Weekly Content Loading
MainStage dynamically loads weekly data from structured JSON files.
Each week file contains:
week metadata
titles
Hebrew / English naming
audio playlists
scripture references
outlines
commentary sections
media links
This allows the app to automatically shift to the next study cycle without manual weekly rebuilding.
Navigation controls allow users to:
move to previous week
move to next week
jump directly to any week from dropdown selection
Week changes trigger global events so other cards and modules can stay synchronized.
Audio Playlist System
MainStage renders a structured playlist for the current week.
Each playlist item includes:
section label (Torah, Prophets, etc.)
audio source
parsed scripture reference
Users can:
play or pause section audio
see current now-playing information
synchronize with the floating Orbit audio player
The playlist normalizes multiple audio source types, including:
English audio
Hebrew audio
Greek audio
This makes MainStage the source of truth for weekly audio routing.
Scripture Link Routing
One of MainStage’s most important functions is scripture reference parsing.
Audio file names contain encoded verse ranges, such as:
01044018-01047027
These are parsed into readable scripture references like:
Genesis 44:18-47:27
These rendered references are clickable.
When clicked, they:
store the scripture reference
launch the Scripture Card
load a focused interlinear reading experience
This creates a bridge between:
weekly audio
scripture navigation
interlinear study tools
Chapter Outlines
MainStage also renders chapter outline summaries.
These provide:
thematic breakdowns
section summaries
reading guidance
Outlines are displayed as expandable content blocks for quick review.
This allows users to preview structure before deeper study.
Video Support
If a week includes video content:
YouTube links are automatically converted into embeddable players
non-YouTube links fall back to external clickable links
This lets MainStage function as a multimedia launch point.
Expandable Study Cards
MainStage also generates collapsible cards for auxiliary weekly content.
These may include:
commentary
notes
topical studies
references
thematic breakdowns
Cards are rendered dynamically from JSON objects.
This makes MainStage extensible without hardcoding new layouts.
User Value
For the user, MainStage answers:
What week are we on?
What should I read?
What should I listen to?
Where do I start?
How do I jump deeper into study?
It reduces friction by making the weekly workflow automatic and centralized.
In short:
MainStage is the command center of the weekly study ecosystem, connecting schedule, scripture, audio, media, and study tools into a single synchronized experience.
