Splash Pages

Splash pages combine Starlight’s template: splash with the local hero.layout schema. Use them for documentation homepages, product entry points, and focused feature hubs.

Live Examples

Centered

Text leads the page and the supporting image follows it. This is the safest default for documentation-first sites.

Open the centered example

Centered Top

The visual appears before the headline. Use it when a diagram, release image, or product surface provides immediate context.

Open the centered-top example

Supported Layouts

Layout	Best use
centered	A documentation entry point with a supporting visual.
centered-top	A visual-first release or product page.
split-left	Product copy on the left and media on the right.
split-right	Media leads the first glance, followed by product copy.
banner	An editorial page with a wide supporting image.

Frontmatter

src/content/docs/index.mdx

template: splash
hero:
  layout: split-left
  announcement:
    text: Version 2.0 is available
    link: /guides/example/
  actions:
    - text: Start building
      link: /guides/example/
      icon: right-arrow

The extra layout and announcement fields are validated by the local schema in src/theme/schema.ts.