Task: Add an image carousel to the website homepage
Table of Contents
This page documents a task in the Documentation improvements story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Add a dependency-free HTML/CSS/JS image carousel to the site homepage
(index.org), replacing the old static hero image + standalone
version screenshot with a single carousel whose first slide is the
hero (splash image + title/subhead/CTA) and whose remaining slides
are a hand-curated set of ORE Studio screenshots with captions,
showcasing the breadth of functionality (market data, org structure,
quant/analytics, data governance, trade capture, reference data).
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Documentation improvements |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-08-04 |
Acceptance
- Carousel replaces the old hero section + standalone version
screenshot at the top of
index.org, with the hero merged into the carousel's first slide. - 7 hand-curated feature screenshots follow, each with a caption.
- Dependency-free (no CDN/external JS library) vanilla JS controller: auto-advance, pause on hover/focus, prev/next buttons, dot nav.
- No image is ever stretched or distorted: every slide uses
object-fit: containat its native aspect ratio, regardless of source resolution. compass site serveactually serves.jsfiles (site build had no publish rule for them before this task).- Secondary "Download" CTA and a one-line tech credibility strip on the hero, per external UX review.
- User-approved final visual state (image-top/solid-text-below card layout for every slide, no pillarboxing/black bars, readable text sizing).
Plan
(Implementation strategy. Written when work starts; key decisions
are distilled into the parent story's * Decisions at close, but the
plan itself stays — it is the historical record of what we did.)
Notes
Test Scenarios
Manual QA scenarios (scaffolded via compass add test_scenario, run
through the QA Validation Runner panel) that verify this task. Link
new ones here as they're created; the scenario doc itself links back
via its "Verifies task" field.
| Scenario | State | Notes |
|---|---|---|
PRs
| PR | Title |
|---|---|
Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|
Result
Shipped and user-approved. Several rounds of visual iteration beyond the initial implementation, each caught by direct feedback and a Gemini UX review:
- Fixed a flexbox min-height bug that was clipping/hiding captions on large screenshots.
- Restored the hero slide's original image-top/text-below layout (initially tried an overlay-on-image style, reverted per feedback).
- Traced "black bars either side of the hero image" through two
false leads (browser cache, then an incomplete flex override) to
the real cause: the site-wide generic
imgrule'smargin: auto, which has free-space-absorbing behaviour in flex layouts and wasn't fully overridden by the carousel-specific rules. - Matched the
object-fit: containletterbox fill colour to the surrounding box background, eliminating a visible seam. - Swapped in real composite (multi-window) screenshots for org chart/ACME, reference data, compute, and shell – old-release stand-ins, flagged for replacement with purpose-built shots in Recapture dedicated carousel screenshots.
- Added a second "Download" CTA and a tech credibility strip per an external UX review; deferred nav consolidation and a quickstart snippet to their own tasks rather than scope-creeping this one.