feat: add modern content and navigation primitives

exampleSite/config/_default/params.toml

@@ -40,7 +40,7 @@ smartTOCHideUnfocusedChildren = false
 fingerprintAlgorithm = "sha512" # Valid values are "sha512" (default), "sha384", "sha256"
 
 [header]
-  layout = "fixed" # valid options: basic, fixed, fixed-fill, fixed-gradient, fixed-fill-blur
+  layout = "floating" # valid options: basic, fixed, fixed-fill, fixed-gradient, fixed-fill-blur, floating
 
 [footer]
   showMenu = true

exampleSite/content/_index.md

@@ -11,6 +11,12 @@ Blowfish gives you expressive layouts, thoughtful defaults, and practical conten
  
 {{< cta url="/docs/" label="Explore the docs" style="outline" >}}
 
+{{< stats >}}
+{{< stat value="5" label="Homepage layouts" >}}Choose the structure that suits the site you are making.{{< /stat >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose expressive content without maintaining one-off templates.{{< /stat >}}
+{{< stat value="100%" label="Your content" >}}Portable Markdown, familiar Hugo configuration, and no lock-in.{{< /stat >}}
+{{< /stats >}}
+
 {{< feature-grid >}}
 {{< feature icon="list-check" title="Make it yours" url="/docs/configuration/" >}}
 A coherent system of layouts, colours, typography, and content controls.
@@ -23,7 +29,20 @@ Explore real sites, community contributions, and patterns that hold up in produc
 {{< /feature >}}
 {{< /feature-grid >}}
 
+## A theme that grows with your work
+
+{{< steps >}}
+{{< step number="1" title="Start with a strong foundation" >}}
+Pick a layout, set your colours and typography, then publish a useful first version.
+{{< /step >}}
+{{< step number="2" title="Build richer pages from content" >}}
+Use shortcodes for calls to action, feature grids, media, diagrams, tabs, and more.
+{{< /step >}}
+{{< step number="3" title="Keep evolving without rewrites" >}}
+Add what your site needs while keeping your content and configuration portable.
+{{< /step >}}
+{{< /steps >}}
+
 {{< alert "circle-info" >}}
 This homepage uses Blowfish's built-in `landing` layout and standard shortcodes. No custom homepage template is required.
 {{< /alert >}}
-

exampleSite/content/docs/configuration/index.md

@@ -226,7 +226,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
 
 | Name | Default | Description |
 | --- | --- | --- |
-| `header.layout` | `"basic"` | Defines the header for the entire site, supported values are `basic`, `fixed`, `fixed-fill`, and `fixed-fill-blur`. |
+| `header.layout` | `"basic"` | Defines the header for the entire site, supported values are `basic`, `fixed`, `fixed-fill`, `fixed-fill-blur`, `fixed-gradient`, and `floating`. |
 
 ### Footer
 

exampleSite/content/docs/shortcodes/index.md

@@ -1441,3 +1441,41 @@ Use `cta` for a clear, accessible call to action inside documentation, landing p
 {{< cta url="/docs/installation/" label="Start building" >}}
 &nbsp;
 {{< cta url="/docs/configuration/" label="Explore configuration" style="outline" >}}
+
+<br/><br/><br/>
+
+## Stats
+
+Use `stats` and `stat` to present concise, high-signal metrics in a responsive grid. The grid uses three columns on large screens by default, or four with `columns="4"`.
+
+```md
+{{</* stats */>}}
+{{</* stat value="40+" label="Shortcodes" */>}}Compose pages without bespoke templates.{{</* /stat */>}}
+{{</* stat value="100%" label="Portable" */>}}Keep your content in Markdown.{{</* /stat */>}}
+{{</* stat value="0" label="Required plugins" */>}}Start with Hugo and Blowfish.{{</* /stat */>}}
+{{</* /stats */>}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+<br/><br/><br/>
+
+## Steps
+
+Use `steps` and `step` for onboarding, processes, roadmaps, and tutorials.
+
+```md
+{{</* steps */>}}
+{{</* step number="1" title="Configure the theme" */>}}Choose a colour scheme and homepage layout.{{</* /step */>}}
+{{</* step number="2" title="Write your content" */>}}Use standard Markdown and shortcodes.{{</* /step */>}}
+{{</* /steps */>}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}