Skip to content

FAQ

Each question is a native details element (Samla’s Accordion), so answers open without JavaScript and are found by in-page search.

Frequently asked questions

Common questions about using and extending the library.

Does Samla need a CMS?
No. The library works by itself, and any CMS can feed content into its props and slots.
Can I use it outside Astro?
The pieces are Astro components. A built site is plain HTML and CSS, so it runs anywhere.
How do I change the colours?
Override the tokens in tokens.css. Surfaces remap them, so components stay readable on every band.
Where do new pieces go?
Small controls in elements, composed pieces in components, and page parts in sections.
  • eyebrow, title (default “Frequently asked questions”), intro: the section header
  • items: list of { question, answer }
  • groups: list of { label, items } to group questions by category, used in place of items
  • grouping: how groups show. headings (default, an h3 per group), tabs (Samla Tabs)
  • layout: stacked (default, one narrow column), split (header and contact prompt beside the questions, sticky on wide screens), columns (questions in two columns)
  • contact: { text, label, href }, a short prompt with a button under the header
  • surface: light, alternate, brand, dark
<Faq
title="Frequently asked questions"
items={[
{ question: "Does Samla need a CMS?", answer: "No. The library works by itself." },
{ question: "Where do new pieces go?", answer: "In elements, components or sections." },
]}
/>
layout="split" with contact, grouped by headings

Frequently asked questions

Can't find what you need? Ask on GitHub.

Open an issue

Getting started

Does Samla need a CMS?
No. The library works by itself, and any CMS can feed content into its props and slots.
Can I use it outside Astro?
The pieces are Astro components. A built site is plain HTML and CSS, so it runs anywhere.

Building

How do I change the colours?
Override the tokens in tokens.css. Surfaces remap them, so components stay readable on every band.
Where do new pieces go?
Small controls in elements, composed pieces in components, and page parts in sections.
layout="columns" surface="alternate"

Support

Frequently asked questions

Can't find what you need? Ask on GitHub.

Open an issue
Does Samla need a CMS?
No. The library works by itself, and any CMS can feed content into its props and slots.
Can I use it outside Astro?
The pieces are Astro components. A built site is plain HTML and CSS, so it runs anywhere.
How do I change the colours?
Override the tokens in tokens.css. Surfaces remap them, so components stay readable on every band.
Where do new pieces go?
Small controls in elements, composed pieces in components, and page parts in sections.
grouping="tabs"

Questions by topic

Does Samla need a CMS?
No. The library works by itself, and any CMS can feed content into its props and slots.
Can I use it outside Astro?
The pieces are Astro components. A built site is plain HTML and CSS, so it runs anywhere.
How do I change the colours?
Override the tokens in tokens.css. Surfaces remap them, so components stay readable on every band.
Where do new pieces go?
Small controls in elements, composed pieces in components, and page parts in sections.
grouping="tabs" layout="split" surface="dark"

Questions

Can't find what you need? Ask on GitHub.

Open an issue
Does Samla need a CMS?
No. The library works by itself, and any CMS can feed content into its props and slots.
Can I use it outside Astro?
The pieces are Astro components. A built site is plain HTML and CSS, so it runs anywhere.
How do I change the colours?
Override the tokens in tokens.css. Surfaces remap them, so components stay readable on every band.
Where do new pieces go?
Small controls in elements, composed pieces in components, and page parts in sections.