Ultramarina Design system View site

Apostrophe build plan

86 components → 16 widgets

Components that show the same kind of thing become one widget with a variant select. Everything else is layout, a piece template, a page template or an internal fragment. Templates are implemented as fragments in Apostrophe (not macros).

Variants are trimmed to what the Figma page frames show (checked 2026-11-11): each one lists the pages it appears on. Variants that only existed in demos are listed as dropped.

Widgets

Placed by editors in page areas. Click a component chip to open it in the library.

  1. 1

    Hero

    9 variants

    One hero for every page top; the variant select drives the layout. Optional mobile-only title / intro: titleMobile accepts line breaks (contact-classique: 'Une question ?⏎Besoin d’aide ?', Figma 1020:48603).

    Merges

    Uses inside

    Variants in the design

    Dropped

    • Light primary — same as Light — Figma's 'Blue Primary' is the light hero
  2. 2

    Banner

    5 variants

    Full-width photo or brand band with a text panel and optional links / buttons. Dark panel on desktop, light glass on mobile (automatic).

    Merges

    Uses inside

    Variants in the design

    Dropped

    • Label above the title — demo only, no frame uses it
    • Light (white glass panel) — no desktop frame uses it — every banner is the dark glass (Figma 754:44427); below lg the light glass is rendered for every banner by CSS, so it needs no select
  3. 3

    Media + text

    4 variants

    50/50 block; buttons and list are options of either side.

    Merges

    Variants in the design

    Dropped

    • Slider (media-slider) — not in the design — Figma uses the Dive centers block on voyage / voyage-2
  4. 4

    Rich text

    5 variants

    Wraps Apostrophe's rich-text; notice is a styled callout variant.

    Merges

    Variants in the design

  5. 5

    Media

    3 variants

    Images or a video; lightbox reuses the modal fragment.

    Merges

    Uses inside

    Variants in the design

  6. 6

    Trips selection

    4 variants

    Picks trips (relationship to the Trip piece) and renders offer cards.

    Merges

    Uses inside

    Variants in the design

    Dropped

    • Deals slider — demo only
    • Deals grid — demo only
  7. 7

    Content cards

    8 variants

    Articles / destinations / options as cards; layout chosen by variant.

    Merges

    Uses inside

    Variants in the design

    Dropped

    • Options popup — demo only, no frame shows it
  8. 8

    Category tiles

    2 variants

    Could be folded into Content cards (→ 15 widgets); kept apart because the design differs.

    Merges

    Uses inside

    Variants in the design

  9. 9

    Destinations

    2 variants

    Destinations from the Destination piece; markers positioned from data.

    Merges

    Uses inside

    Variants in the design

    Dropped

    • List only — every list in the design is either with the map or grouped by region
  10. 10

    Testimonials

    4 variants

    Reviews from the Review piece, or staff quotes. The list variant is Figma's 'Popup - Avis voyage' 2271:35051.

    Merges

    Uses inside

    Variants in the design

    Dropped

    • Staff — quote + text — not in the design: every staff block (desktop and both mobile versions) is the big quote
  11. 11

    Team

    1 variant

    Team members (people piece or repeater). One look only → no variant select needed. Slider nav: bars + arrows on desktop, centred arrows only below lg (CSS).

    Merges

    Variants in the design

    Dropped

    • Blue background — demo only
  12. 12

    Key figures

    2 variants

    Repeater of value / label / text.

    Merges

    Variants in the design

  13. 13

    Facts table

    2 variants

    Structured tables for destinations, boats and centres.

    Merges

    Variants in the design

  14. 14

    FAQ

    1 variant

    Repeater of question / answer (rich text + optional image).

    Merges

    Uses inside

    Variants in the design

    Dropped

    • Plain accordion — no frame places a bare accordion — it only lives inside FAQ and the hotel rooms
  15. 15

    Calls to action

    3 variants

    Contact entry points; agencies from an Agency piece. Bracket title with an optional second line (titleLine2 'en agence', break from lg). Agency cards: editors order agencies row by row (Nantes, Paris, Lyon…); the cards render column by column (Nantes, Lyon, Villeneuve | Paris, Genève — Figma 511:51838 / mobile 1021:50002). CTA card titles 24/42 below lg, 32/42 from lg.

    Merges

    Uses inside

    Variants in the design

    Dropped

    • Agency contact bar (3 looks) — in the Figma components page, but no page frame uses it
  16. 16

    Form

    3 variants

    Use @apostrophecms/form with a theme template rather than a custom widget.

    Merges

    Uses inside

    Variants in the design

Optional

Anchor bar — anchor-bar Better generated by the page from its sections than placed by hand. On: Bateau, Centre de plongée, Page d'un voyage 1 (avec carte et 1 hôtel), Page d'un voyage 2 (sans carte et + 2 hôtels)

Dropped (not in the design)

  • Hero · Light primary — same as Light — Figma's 'Blue Primary' is the light hero
  • Banner · Label above the title — demo only, no frame uses it
  • Banner · Light (white glass panel) — no desktop frame uses it — every banner is the dark glass (Figma 754:44427); below lg the light glass is rendered for every banner by CSS, so it needs no select
  • Media + text · Slider (media-slider) — not in the design — Figma uses the Dive centers block on voyage / voyage-2
  • Trips selection · Deals slider — demo only
  • Trips selection · Deals grid — demo only
  • Content cards · Options popup — demo only, no frame shows it
  • Destinations · List only — every list in the design is either with the map or grouped by region
  • Testimonials · Staff — quote + text — not in the design: every staff block (desktop and both mobile versions) is the big quote
  • Team · Blue background — demo only
  • FAQ · Plain accordion — no frame places a bare accordion — it only lives inside FAQ and the hotel rooms
  • Calls to action · Agency contact bar (3 looks) — in the Figma components page, but no page frame uses it
  • media-slider — Built from the components page; the voyage frames use the Dive centers block there instead.
  • agency-contact-bar — Component exists in Figma but no page frame places it.

Globals (layout)

Edited once in Apostrophe's global settings, rendered by the layout.

Footer

Trust signals, socials, newsletter, sister brands, legal links. Gallery variant: 18 photos → 3 pager bars, as in Figma.

Piece types

Content types; their cards and show-page parts are rendered from data, never placed by hand.

Trip (voyage / croisière)

Cruise cards in a listing always open their dates as a separate framed panel under the card (desktop 494:27249, mobile 1210:39841). Hero OFFER: category pastilles use the light round icons on the primary background (754:43716); no photo credit (Figma shows none).

Article (reportage / guide)
Destination
Review
Job offer
Dive centre · boat · cruise operator
Experience / trip type (categories)