Generic font families

Cargo.toml

@@ -3877,6 +3877,18 @@ description = "Demonstrates how to display text with strikethrough and underline
 category = "UI (User Interface)"
 wasm = true
 
+[[example]]
+name = "generic_font_families"
+path = "examples/ui/generic_font_families.rs"
+# Causes an ICE on docs.rs
+doc-scrape-examples = false
+
+[package.metadata.example.generic_font_families]
+name = "Generic Font Families"
+description = "Demonstrates how to use generic font families"
+category = "UI (User Interface)"
+wasm = true
+
 [[example]]
 name = "text"
 path = "examples/ui/text.rs"

crates/bevy_text/src/pipeline.rs

@@ -189,6 +189,11 @@ impl TextPipeline {
                         Family::Name(font.family_name.as_str())
                     }
                     FontSource::Family(family) => Family::Name(family.as_str()),
+                    FontSource::Serif => Family::Serif,
+                    FontSource::SansSerif => Family::SansSerif,
+                    FontSource::Cursive => Family::Cursive,
+                    FontSource::Fantasy => Family::Fantasy,
+                    FontSource::Monospace => Family::Monospace,
                 };
 
                 // Save spans that aren't zero-sized.

crates/bevy_text/src/text.rs

@@ -262,6 +262,31 @@ pub enum FontSource {
     Handle(Handle<Font>),
     /// Resolve the font by family name using the font database.
     Family(SmolStr),
+    /// Fonts with serifs — small decorative strokes at the ends of letterforms.
+    ///
+    /// Serif fonts are typically used for long passages of text and represent
+    /// a more traditional or formal typographic style.
+    Serif,
+    /// Fonts without serifs.
+    ///
+    /// Sans-serif fonts generally have low stroke contrast and plain stroke
+    /// endings, making them common for UI text and on-screen reading.
+    SansSerif,
+    /// Fonts that use a cursive or handwritten style.
+    ///
+    /// Glyphs often resemble connected or flowing pen or brush strokes rather
+    /// than printed letterforms.
+    Cursive,
+    /// Decorative or expressive fonts.
+    ///
+    /// Fantasy fonts are primarily intended for display purposes and may
+    /// prioritize visual style over readability.
+    Fantasy,
+    /// Fonts in which all glyphs have the same fixed advance width.
+    ///
+    /// Monospace fonts are commonly used for code, tabular data, and text
+    /// where vertical alignment is important.
+    Monospace,
 }
 
 impl Default for FontSource {

examples/README.md

@@ -581,6 +581,7 @@ Example | Description
 [Font Atlas Debug](../examples/ui/font_atlas_debug.rs) | Illustrates how FontAtlases are populated (used to optimize text rendering internally)
 [Font Queries](../examples/ui/font_query.rs) | Demonstrates font querying
 [Font Weights](../examples/ui/font_weights.rs) | Demonstrates how to use font weights.
+[Generic Font Families](../examples/ui/generic_font_families.rs) | Demonstrates how to use generic font families
 [Ghost Nodes](../examples/ui/ghost_nodes.rs) | Demonstrates the use of Ghost Nodes to skip entities in the UI layout hierarchy
 [Gradients](../examples/ui/gradients.rs) | An example demonstrating gradients
 [Overflow](../examples/ui/overflow.rs) | Simple example demonstrating overflow behavior

examples/ui/generic_font_families.rs

@@ -0,0 +1,52 @@
+//! This example demonstrates generic font families
+
+use bevy::{prelude::*, text::CosmicFontSystem};
+
+fn main() {
+    let mut app = App::new();
+    app.add_plugins(DefaultPlugins).add_systems(Startup, setup);
+
+    app.world_mut()
+        .resource_mut::<CosmicFontSystem>()
+        .db_mut()
+        .load_system_fonts();
+
+    app.run();
+}
+
+fn setup(mut commands: Commands) {
+    // UI camera
+    commands.spawn(Camera2d);
+
+    commands.spawn((
+        Node {
+            flex_direction: FlexDirection::Column,
+            left: px(250),
+            top: px(250),
+            row_gap: px(10.),
+            ..Default::default()
+        },
+        children![
+            (
+                Text::new("generic sans serif font"),
+                TextFont::from(FontSource::SansSerif).with_font_size(30.)
+            ),
+            (
+                Text::new("generic serif font"),
+                TextFont::from(FontSource::Serif).with_font_size(30.)
+            ),
+            (
+                Text::new("generic fantasy font"),
+                TextFont::from(FontSource::Fantasy).with_font_size(30.)
+            ),
+            (
+                Text::new("generic cursive font"),
+                TextFont::from(FontSource::Cursive).with_font_size(30.)
+            ),
+            (
+                Text::new("generic monospace font"),
+                TextFont::from(FontSource::Monospace).with_font_size(30.)
+            )
+        ],
+    ));
+}

release-content/release-notes/generic_font_families.md

@@ -0,0 +1,7 @@
+---
+title: "Generic Font Families"
+authors: ["@ickshonpe"]
+pull_requests: []
+---
+
+Support for generic font families has been added through new `FontSource` variants: `Serif`, `SansSerif`, `Cursive`, `Fantasy`, and `Monospace`.