Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(theme-neutral): document Figtree and its loading snippet (#6079)

AK44858524826c
diff --git a/.changeset/neutral-figtree-docs.md b/.changeset/neutral-figtree-docs.md
new file mode 100644
index 0000000000..755afc4611
--- /dev/null
+++ b/.changeset/neutral-figtree-docs.md
@@ -0,0 +1,6 @@
+---
+'@astryxdesign/theme-neutral': patch
+---
+
+[docs] Describe Neutral as Figtree typography and add the font-loading snippet; the README claimed system fonts while the theme declares Figtree. (#5991)
+@AKnassa
diff --git a/packages/cli/assets/docs/theme.doc.mjs b/packages/cli/assets/docs/theme.doc.mjs
index 070771d6bb..95fe3c9de6 100644
--- a/packages/cli/assets/docs/theme.doc.mjs
+++ b/packages/cli/assets/docs/theme.doc.mjs
@@ -76,7 +76,7 @@ function App() {
[
'Neutral',
"import {neutralTheme} from '@astryxdesign/theme-neutral'",
- 'Muted, minimal aesthetic with system fonts. A good starting point.',
+ 'Muted, minimal aesthetic with Figtree typography. A good starting point.',
],
[
'Butter',
diff --git a/packages/themes/neutral/README.md b/packages/themes/neutral/README.md
index cc25eda5cb..de36129fb7 100644
--- a/packages/themes/neutral/README.md
+++ b/packages/themes/neutral/README.md
@@ -1,6 +1,6 @@
# @astryxdesign/theme-neutral
-Muted, minimal aesthetic with system fonts. Uses [Lucide](https://lucide.dev) icons.
+Muted, minimal aesthetic with Figtree typography. Uses [Lucide](https://lucide.dev) icons.
## Install
@@ -82,7 +82,29 @@ Add the theme CSS to your stylesheet:
This is required for component-level theme overrides (colors, radii, typography) to take effect.
-This theme uses system fonts; no external font loading is required.
+## Fonts
+
+This theme uses a custom typeface:
+
+| Role | Font |
+| ------- | --------------------------- |
+| Body | Figtree |
+| Heading | Figtree |
+| Code | System monospace (built in) |
+
+**Figtree must be loaded separately.** The theme references it by name but does not bundle the font files.
+
+Add this to your HTML `<head>`:
+
+```html
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link
+ rel="stylesheet"
+ href="https://fonts.googleapis.com/css2?family=Figtree:wght@400;500;600;700&display=swap" />
+```
+
+Without this, the theme falls back to system fonts. If you'd rather avoid external font requests entirely (offline apps, no-third-party-request policies), that fallback is a supported choice — the system stack is designed to hold up on its own.
## Related Packages