Ultramarina Design system View site

Apostrophe build

What's built so far

The parts of the design that already exist in the Apostrophe project, and what's next. Updated 2026-11-18. To update it, edit src/data/apostropheProgress.json.

Foundations

Styles, fonts and scripts every part builds on.

  1. Design tokens, tools and base styles

    Done

    Ported from UM Designs; compiles to the same CSS. No hardcoded values: tokens or named extended tokens.

    In Apostrophe

    • modules/asset/ui/src/scss/tokens
    • modules/asset/ui/src/scss/tools
    • modules/asset/ui/src/scss/base
  2. Component styles (all 86)

    Done

    Every component's SCSS is ported; the markup is added part by part (see below).

    In Apostrophe

    • modules/asset/ui/src/scss/components
    • modules/asset/ui/src/scss/groups
  3. Fonts

    Done

    Self-hosted Poppins.

    In Apostrophe

    • modules/asset/public/fonts
  4. Icons and images

    Done

    Theme icons by category; header and icon-link icons from one token map ($theme-icons).

    In Apostrophe

    • public/images/icons
    • public/images/logo
  5. Scripts: Alpine, Splide, Litepicker

    Done

    From npm. Each component brings its own Alpine script when it is ported (site-header.js so far).

    In Apostrophe

    • modules/asset/ui/src/index.js
    • modules/asset/ui/src/js
  6. Fixes for the admin UI

    Done

    Site styles broken by the logged-in admin bar, scoped to html:has(#apos-admin-bar). First fix: no sideways shift when a mega-menu opens.

    In Apostrophe

    • modules/asset/ui/src/_apos-overwrites.scss

Page layout

The blocks every page shares, included one by one in views/layout.html.

  1. Layout includes

    Done

    One include per block: info banner, site header, pre-footer, footer.

    In Apostrophe

    • views/layout.html
  2. Info banner

    In progress

    Design markup with sample messages (CSS marquee). To do: a Global setting for the messages and an on/off switch.

    Design components

    In Apostrophe

    • views/info-banner/info-banner.html
  3. Site header: top bar

    Done

    Global › Top Navigation: menu groups (dropdowns) and icon links (theme icons). Edited in Global settings.

    Design components

    In Apostrophe

    • views/site-header/site-header.html
    • modules/widgets/menu-group-widget
    • modules/widgets/icon-link-widget
  4. Site header: main menu, mega-menus, mobile drawer

    Done

    Global › Menu: sections › groups › links ("Show with an arrow" = heading link), link widgets as buttons in the bar. Logo from Global. Hover menus, chevron flips when open.

    Design components

    In Apostrophe

    • views/site-header/site-header.html
    • views/fragments/header/menu.html
    • modules/widgets/menu-section-widget
    • modules/widgets/menu-link-widget
    • modules/asset/ui/src/js/site-header.js
  5. Destinations menu

    In progress

    Full design, hardcoded for now (cards, counts, columns, level 4). Opens on hover like the other mega-menus (Figma shows click; changed on request). To do: fed by the hub's destination tree.

    Design components

    In Apostrophe

    • views/fragments/header/destinations.html
  6. Trust component

    In progress

    The trust-card widget is the component (classes trust-card, __icon, __title, __text), styled by where it sits. The title is a p, not a heading (SEO review in Figma: no headings in the pre-footer / footer). Pre-footer: like the design (4 × 331 × 228), also in edit mode (fix in _apos-overwrites). Menu: Global › Menu trust cards in a .trust row under every mega-menu (dark 72px bar) and at the bottom of the mobile drawer (light strip), titles only. All its styles: scss/components/trust. Content still placeholders. To do: the home / footer trust bar.

    Design components

    In Apostrophe

    • modules/widgets/trust-card-widget
    • modules/asset/ui/src/scss/components/trust
    • views/layout.html
    • views/fragments/header/menu.html
    • views/fragments/header/destinations.html
    • modules/asset/ui/src/_apos-overwrites.scss
  7. Footer

    In progress

    Global › Footer area built with layout widgets. The design's site footer markup is not ported yet.

    Design components

    In Apostrophe

    • views/layout.html

Widgets

What editors can place in areas.

  1. Link widget (links and the design's buttons)

    Done

    Text links (normal, bold, underlined) and 14 button styles: primary, outline, light, link, 7 round arrows, 3 round badges (+ inverse, small). Each style's value is its class list; arrows and badges are drawn in CSS. Matches Figma.

    Design components

    In Apostrophe

    • modules/widgets/link-widget
  2. Icon link

    Done

    Theme icon + link; header look inside the header, neutral look elsewhere.

    In Apostrophe

    • modules/widgets/icon-link-widget
  3. Menu section, menu group, menu link

    Done

    Two fragments each: site markup, and a readable preview in the Global dialog (useAdminStyling).

    Design components

    In Apostrophe

    • modules/widgets/menu-section-widget
    • modules/widgets/menu-group-widget
    • modules/widgets/menu-link-widget
  4. Trust card

    Done

    Icon, title (a p, not a heading), text. Global › Pre-footer holds 4 cards (pictogram + texts).

    Design components

    In Apostrophe

    • modules/widgets/trust-card-widget
  5. Reviews (testimonials)

    To do

    Not ported yet. The design's review card carries schema.org Review microdata (itemReviewed TouristTrip, author Person, reviewRating, reviewBody), asked for in the SEO review: keep it when porting. Google only shows review stars for some types (e.g. Product): to confirm with the SEO.

    Design components

  6. Social media

    Done

    Fed by the SEO social profiles.

    In Apostrophe

    • modules/widgets/social-media-widget
  7. Newsletter subscription

    In progress

    Widget and service skeleton, shared form pipeline (form-base).

    In Apostrophe

    • modules/widgets/newsletter-subscription-widget
    • modules/forms
  8. Content widgets from the widget plan

    To do

    The remaining widgets of the widget plan (heroes, media + text, sliders, cards…). Demo widgets still to replace: hero, article, github-prs.

Pages and content types

Page templates and pieces.

  1. Maintenance mode and page

    Done

    Global › Maintenance: visitors get the maintenance page with a 503.

    In Apostrophe

    • modules/pages/maintenance-page
    • modules/asset/ui/src/_maintenance.scss
  2. Page templates

    To do

    Home, trips, destinations, editorial, corporate pages: see the widget plan.

  3. Pieces (trips, destinations, articles…)

    To do

    Content model still to decide (part of it comes from the hub).