Velocity X Components

Long-form

Chapter Divider

A full section break for very long pieces — ebooks, multi-part guides, long docs — so the reader feels a real page turn between chapters instead of just another heading in the scroll. Numbered kicker, title and an optional standfirst, flanked by hairline rules on both themes.

Subscription Included with the Velocity Components subscription.
bash
$ velocityx add chapter-divider

Built for astro.

Full docs for Chapter Divider →

Needs a licence key — subscribe here, then velocityx loginonce.

astro v1.0.1
Chapter Divider

Part Two

Chapter 4

Shipping Without a Spec

Why the build beats the brief, and when that stops being true.

Props

NameTypeRequiredDefaultDescription
numbernumber | stringYesChapter number — rendered as-is, so pass "IV" or "04" if you want that instead of a plain integer.
titlestringYes
eyebrowstringNoSmall label above the number, e.g. "Part Two" or a book/section name.
standfirststringNoShort dek beneath the title.
level1 | 2 | 3No2Heading rank for the title — defaults to 2. Set to 1 only if this is the page's single top-level heading.

File this creates

The CLI writes this path into your project, relative to its root — nothing else moves.

text
components/velocity/chapter-divider/ChapterDivider.astro

Using the Chapter Divider component

Install it with velocityx add chapter-divider. The CLI writes the source straight into your project — no runtime dependency, no registry lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.

More from Long-form.