Universal Hero Cards

When a client opens their itinerary link, the first thing they see on the At a glance page is a Highlights section. This is where the big, magazine-style hero cards for their cruise ships and theme parks live.

These cards are richer than the per-day blocks — they pull from the full JourneyFuse ship catalog, the park schedule cache, and cruise sailing data to give clients a trip-level briefing before they drill into specific days.

Two flavors today:

• Ship Overview — one card per cruise on the trip
• Park Overview — one card per Disney / Universal park on the trip

Both use the same magazine layout: hero image → sticky tab bar → deep-dive content per tab. Clients can tap any tab for more detail, and the whole thing collapses to the Overview tab only when they print or download the PDF.

Ship Overview Card

When does it appear?

A Ship Overview card appears automatically whenever a cruise booking is attached to a trip. Behind the scenes, a cruise_overview block gets inserted on day 1 of the trip when you fill out the booking — you don't need to add it manually.

What the tabs show

Tab	Source	What's in it
Overview	Ship catalog	Ship description, launch year, passenger capacity, gross tonnage
Itinerary	Booking + Sailings DB	Port-by-port rail: arrival/departure times, sea-day badges, embarkation & disembarkation markers
Your cabin	Booking's stateroom selection	Booked cabin image, sq ft, occupancy, amenities, plus other cabin categories on the ship
Dining	Ship catalog	Venues grouped into Complimentary vs. Specialty; adults-only tag; descriptions
Activities	Ship catalog	Featured entertainment, shows, experiences
Tips	Per-cruise-line curated list	"Know before you go" tips tailored to Royal Caribbean, Disney Cruise Line, Carnival, NCL, etc.

How the Itinerary tab works

There are two ways the port-by-port itinerary gets populated:

1. Manual (preferred) — when you enter cruise days on the booking via Booking → Cruise Days, those ports + times show up in the Itinerary tab. Anything you edit there overrides the fallback.
2. Automatic fallback — if you haven't entered cruise days, JourneyFuse matches the booking's (cruise line, ship, sailing date) against our scraped sailings database (50k+ sailings from CruiseMapper) and pulls the itinerary from there. Clients see a full port-by-port plan with no work on your part.

Agent-entered data always wins. The fallback kicks in only when no manual cruise days exist.

Hero image

The hero image at the top of the card comes from the ship catalog. Every ship in the catalog (623 as of April 2026) has a hero image — major ocean liners use their Wikipedia photo; smaller river/expedition ships use a stock cruise photo.

If a ship is missing or has the wrong image, head to Settings → Ship Catalog, find the ship, and use the image refresh button.

Park Overview Card

When does it appear?

Whenever a park_day block exists on the itinerary for a recognized park, a Park Overview hero card appears at the top. It auto-inserts on the earliest day the park is referenced.

Currently recognized parks: Magic Kingdom, EPCOT, Disney's Hollywood Studios, Disney's Animal Kingdom, Disneyland Park, Disney California Adventure, Universal Studios Florida, Islands of Adventure, Epic Universe.

Any park outside this list will still render a generic card if a park_overview block is added manually, but the tab pattern works best with the curated parks.

What the tabs show

Tab	Source	What's in it
Overview	Park profile	Hero image, tagline, description, quick stats (park days, hours coverage, tips count)
Schedule	ThemeParks.wiki	Open / close times for every trip date the park is visited
Tips	Per-park curated list	Walk-through tips: rope drop strategy, Lightning Lane timing, park-break suggestions, Express Pass advice for Universal

Multiple parks on the same trip each get their own card (e.g., a 7-day Disney World trip would show cards for Magic Kingdom, EPCOT, Hollywood Studios, and Animal Kingdom if all four are on the itinerary).

Auto-seed behavior

When you add a park_day block with a recognized park, a matching park_overview hero card is created automatically. If one already exists for that park on that trip, nothing happens (it's idempotent — you won't get duplicates).

Print Behavior

When a client prints their itinerary or downloads the PDF:

• Both hero cards render inline
• Only the Overview tab's content is included — tabs, their content, and the tab bar itself are hidden
• Hero image and stats come through
• Everything else (Itinerary tab, Dining tab, etc.) is stripped so the PDF stays concise

This keeps printed itineraries looking tight while the web version remains rich and explorable.

Tips for Advisors

• Fill the booking's cruise days if you want times and port notes that differ from the scraped sailing. Otherwise, the automatic fallback is usually good enough.
• Use the block picker's "Park Overview" entry only if you want to add a park manually that's outside the 9 curated parks, or if you want the hero card on a trip without any park_day blocks.
• The Trip Map in the sidebar now draws a polyline connecting cruise ports in order. It pulls from the same sailing data, so it works even without manual cruise days.
• Curated tips are global for now. If you want workspace-specific tips, let us know — a park_profiles / cruise_line_tips table is on the roadmap.