Skip to content

Steps

An ordered list, so screen readers announce the step count and position. The horizontal row switches to the vertical layout below tablet width.

How it works

From install to first page

  1. Install the library

    Add @samla/ui to an Astro project as a dependency.

  2. Import global.css

    Load the base styles once in the site layout.

  3. Compose a page

    Import sections and fill their props and slots.

  4. Set your tokens

    Override colour and type tokens to fit the brand.

  • eyebrow, title, intro: optional section header. Without title, step titles become h2
  • steps: list of { title, text?, icon?, image?, imageAlt? }
  • orientation: horizontal (default), vertical (in a narrow container)
  • marker: number (default), icon (uses each step’s icon, falling back to its number)
  • align: start (default), center. Centres the header and, in horizontal rows, each step
  • image per step: shown above the title in a row, beneath the text in a column
  • surface: light, alternate, brand, dark
<Steps
eyebrow="How it works"
title="From install to first page"
steps={[
{ title: "Install the library", text: "Add @samla/ui to an Astro project." },
{ title: "Import global.css", text: "Once, in the site layout." },
{ title: "Compose a page", text: "Fill section props and slots." },
]}
/>
orientation="vertical" marker="icon"

Getting started

  1. Install the library

    Add @samla/ui to an Astro project as a dependency.

  2. Import global.css

    Load the base styles once in the site layout.

  3. Compose a page

    Import sections and fill their props and slots.

  4. Set your tokens

    Override colour and type tokens to fit the brand.

align="center" surface="alternate", three steps

Three steps to a page

  1. Install the library

    Add @samla/ui to an Astro project as a dependency.

  2. Import global.css

    Load the base styles once in the site layout.

  3. Compose a page

    Import sections and fill their props and slots.

Media per step, surface="dark"

What you do next

  1. Install the library

    Add @samla/ui to an Astro project as a dependency.

  2. Import global.css

    Load the base styles once in the site layout.

  3. Compose a page

    Import sections and fill their props and slots.