Skip to content
@jordanlee
documentation

Customization

Component reference

The reusable building blocks: buttons, callouts, tabs, cards, and more.

on this page

Authoring components (MDX)

Available in any .mdx file without an import.

Callout

<Callout type="tip" title="Optional title">
Body text with **Markdown**.
</Callout>

type is one of note (default), tip, warning, danger.

Tabs

<Tabs tabs={['npm', 'pnpm']}>
<div>first panel</div>
<div>second panel</div>
</Tabs>

Children are matched to labels by order. Panels are keyboard-navigable with the arrow keys.

UI primitives (src/components/ui/)

Component Purpose
Button <a> or <button>; variants primary, secondary, ghost
Icon Inline SVG icons — see the icons map for names
Section Homepage section with a lowercase title and “view all” link
Pagination Newer / Older links for paginated lists
Breadcrumbs Trail with schema-friendly markup
CopyButton Copies a string to the clipboard
Callout See above
Tabs See above

Layout (src/components/layout/)

Component Purpose
Header Site name, navigation, optional purchase button, colour-scheme toggle
MobileNav Collapsible navigation under md
ThemeToggle Light/dark toggle, persisted in localStorage
Starfield The animated canvas background
SocialLinks Icon row from siteConfig.social
Footer Copyright range, social icons, credits

Content components

Component Purpose
posts/PostRow Title + date · tags row used in every post list
posts/TagBadge Bordered chip linking to a tag page
posts/SeriesNav “See also in” block for posts sharing a series
posts/TableOfContents Sidebar (with scroll-spy) and mobile variants
projects/ProjectCard Media, kicker, title, description, skills, project/source buttons
docs/DocsSidebar Grouped docs navigation

Layouts (src/layouts/)

BaseLayout renders <head>, the header, footer, starfield, and analytics. PostLayout, ProjectLayout, DocsLayout, and PageLayout wrap it for each content type. Pass title, description, image, noindex, or extra jsonLd objects to BaseLayout from any page.