Splash Pages

Splash pages use Starlight’s template: splash and the plugin’s hero.layout frontmatter. They are best for docs homepages, product entry points, release guides, and focused feature hubs.

Layout Gallery

Centered

A classic docs landing page. Text comes first, optional media sits below it, and actions stay close to the headline.

Open the centered example

Centered Top

Useful when the image or product surface should be seen before the copy.

Open the centered-top example

Split Left

A strong product-docs layout with copy on the left and media on the right.

Open the split-left example

Split Right

The mirrored split layout. Good when the media should lead and the copy should close the pitch.

Open the split-right example

Banner

A wide editorial layout with copy and metadata above a full-width visual.

Open the banner example

Frontmatter

---
title: Integration Platform
description: Build, document, and operate internal integrations from one place.
template: splash
hero:
    layout: split-left
    announcement:
        text: Version 2.0 is available
        link: /guides/getting-started/
    image:
        file: ../../../assets/placeholder.svg
    actions:
        - text: Start building
          link: /guides/getting-started/
          icon: right-arrow
        - text: Customize theme
          link: /guides/theming/
          variant: minimal
---

Choosing a Layout

Layout	Use when
centered	The page is mostly a documentation entry point and does not need a dominant visual.
centered-top	The visual is the main recognition point for the product, release, or concept.
split-left	You want a familiar product homepage rhythm with text leading the page.
split-right	You want the image to anchor the first glance before the reader reaches the copy.
banner	You want a wider editorial page with a large supporting image below the copy.

The homepage of this documentation site uses the default centered splash treatment with no hero image. That is often enough for a small library. Add imagery when it helps readers understand the product, not just to fill the page.