feat: clean up homepage

Assisted-by: Copilot:claude-sonnet-4.6
Signed-off-by: Henry Schreiner <henryfs@princeton.edu>

Author: henryiii

.github/copilot-instructions.md

@@ -0,0 +1,55 @@
+# Copilot Instructions — scikit-build.github.io
+
+Hugo site for [scikit-build.org](https://scikit-build.org). Uses the [PaperMod](https://github.com/adityatelange/hugo-PaperMod) theme loaded as a Hugo module (not a git submodule).
+
+## Commands
+
+```bash
+# Build the site (output to public/)
+hugo build
+
+# Live-reload dev server (drafts included)
+hugo server --buildDrafts
+
+# Build for production (minified, correct baseURL)
+hugo --minify --baseURL "https://scikit-build.org/"
+
+# Update Hugo module dependencies
+hugo mod tidy
+```
+
+> Hugo v0.146.0+ and Go are both required (PaperMod enforces this at build time).
+
+## Architecture
+
+The home page is fully custom — it does **not** use PaperMod's built-in list or profile modes.
+
+| File | Role |
+|---|---|
+| `layouts/index.html` | Custom home page template (hero + project cards grid). Overrides PaperMod's default list layout for the home page only. |
+| `data/projects.yaml` | Single source of truth for all project cards. Iterated via `{{- range hugo.Data.projects }}` in the template. |
+| `assets/css/extended/homepage.css` | Custom CSS loaded automatically by PaperMod from `assets/css/extended/`. Uses PaperMod CSS variables (`--border`, `--primary`, `--theme`, `--entry`, `--secondary`) for automatic dark mode support. |
+| `hugo.toml` | Site config, PaperMod params, and nav menu. |
+
+PaperMod layouts (in the Hugo module cache) can be browsed after running `hugo mod vendor`, which writes them to `_vendor/` (gitignored).
+
+## Key Conventions
+
+**Adding a project card:** Add an entry to `data/projects.yaml`. Supported fields:
+- `name` (required), `description` (required), `github` (required)
+- `docs` — if present, a Docs badge appears on the card
+- `pypi` — if present, a PyPI badge appears on the card
+- `primary: true` — renders a highlighted "Core" badge and thicker border
+
+**Adding a new page** (e.g. tutorials): Create `content/tutorials/my-page.md` with front matter. Add a `[[menu.main]]` entry in `hugo.toml` to surface it in the nav. PaperMod's standard `single.html` layout is used automatically.
+
+**CSS:** All custom styles go in `assets/css/extended/`. Files here are automatically concatenated and minified by PaperMod — no import needed. Always use PaperMod's CSS variables rather than hard-coded colours so dark mode works for free. The hero logo uses `filter: invert(1)` under `.dark` to remain visible on dark backgrounds.
+
+**Logo assets** live in `static/images/` (SVGs) and `static/` (favicon PNG), sourced from the [scikit-build/scikit-build](https://github.com/scikit-build/scikit-build/tree/main/docs/logo) repo:
+- `scikit_build_logo.svg` — wide lockup used in the hero (1167×262.6)
+- `scikit_build_mark.svg` — square mark used in the nav header (`params.label.icon`)
+- `favicon.png` — mark PNG used as site favicon (`params.assets.favicon*`)
+
+**Hugo module updates:** The theme is pinned via `go.sum`. Run `hugo mod get github.com/adityatelange/hugo-PaperMod@master && hugo mod tidy` to update it.
+
+**Deployment:** Pushing to `main` triggers `.github/workflows/deploy.yml`, which builds with Hugo (extended) and deploys to GitHub Pages via the Actions Pages API. No manual publish step needed.

assets/css/extended/homepage.css

@@ -6,11 +6,17 @@
   margin-bottom: 3rem;
 }
 
-.home-hero-title {
-  font-size: 2.8rem;
-  font-weight: 800;
-  margin: 0 0 0.75rem;
-  letter-spacing: -0.02em;
+.home-hero-logo {
+  max-width: 420px;
+  width: 100%;
+  height: auto;
+  margin: 0 auto 1.5rem;
+  display: block;
+}
+
+/* Invert the logo in dark mode so it stays visible */
+.dark .home-hero-logo {
+  filter: invert(1);
 }
 
 .home-hero-subtitle {
@@ -37,23 +43,20 @@
   font-size: 0.95rem;
   font-weight: 600;
   text-decoration: none;
-  transition: opacity 0.15s;
+  color: var(--primary);
+  background: transparent;
+  border: 2px solid var(--border);
+  transition: border-color 0.15s, background 0.15s;
 }
 
 .home-btn:hover {
-  opacity: 0.85;
-}
-
-.home-btn-primary {
-  background: var(--theme);
-  color: var(--primary);
-  border: 2px solid var(--primary);
+  border-color: var(--primary);
+  background: var(--entry);
 }
 
+.home-btn-primary,
 .home-btn-secondary {
-  background: transparent;
-  color: var(--primary);
-  border: 2px solid var(--border);
+  /* intentionally empty — both buttons share the same style */
 }
 
 /* ── Projects section ────────────────────────────────────────────────────── */
@@ -94,11 +97,6 @@
   transform: translateY(-2px);
 }
 
-.project-card-primary {
-  border-color: var(--primary);
-  border-width: 2px;
-}
-
 .project-card-header {
   display: flex;
   align-items: center;
@@ -115,13 +113,13 @@
 
 .project-card-badge {
   font-size: 0.65rem;
-  font-weight: 700;
+  font-weight: 600;
   text-transform: uppercase;
   letter-spacing: 0.05em;
   padding: 0.15rem 0.45rem;
   border-radius: 4px;
-  background: var(--primary);
-  color: var(--theme);
+  border: 1px solid var(--border);
+  color: var(--secondary);
   white-space: nowrap;
 }
 

data/projects.yaml

@@ -5,40 +5,58 @@
   github: https://github.com/scikit-build/scikit-build-core
   docs: https://scikit-build-core.readthedocs.io/
   pypi: https://pypi.org/project/scikit-build-core/
-  primary: true
+  labels: ["build backend"]
 
-- name: scikit-build
+- name: scikit-build (classic)
   description: >-
     The original improved build system generator for CPython C, C++, Cython,
     and Fortran extensions. A bridge between setuptools and CMake.
   github: https://github.com/scikit-build/scikit-build
   docs: https://scikit-build.readthedocs.io/
   pypi: https://pypi.org/project/scikit-build/
+  labels: ["build backend"]
 
 - name: cmake-python-distributions
   description: >-
     Provides infrastructure to build and distribute CMake as a Python wheel,
     making CMake easily installable via pip on all major platforms.
   github: https://github.com/scikit-build/cmake-python-distributions
   pypi: https://pypi.org/project/cmake/
+  labels: ["binary"]
 
 - name: ninja-python-distributions
   description: >-
     Provides infrastructure to build and distribute Ninja as a Python wheel,
     making the Ninja build system easily installable via pip.
   github: https://github.com/scikit-build/ninja-python-distributions
   pypi: https://pypi.org/project/ninja/
+  labels: ["binary"]
 
 - name: cython-cmake
   description: >-
     CMake helpers for building Cython extension modules, making it easier to
     integrate Cython into CMake-based build systems.
   github: https://github.com/scikit-build/cython-cmake
   pypi: https://pypi.org/project/cython-cmake/
+  labels: ["CMake"]
 
 - name: f2py-cmake
   description: >-
     CMake helpers for building Fortran extension modules via F2Py, enabling
     Fortran code to be easily wrapped and called from Python.
   github: https://github.com/scikit-build/f2py-cmake
   pypi: https://pypi.org/project/f2py-cmake/
+  labels: ["CMake"]
+
+- name: moderncmakedomain
+  description: >-
+    A Sphinx domain for Modern CMake, providing rich cross-referencing and
+    documentation support for CMake commands, variables, and modules.
+  github: https://github.com/scikit-build/moderncmakedomain
+  pypi: https://pypi.org/project/moderncmakedomain/
+
+- name: scikit-build-sample-projects
+  description: >-
+    Sample projects demonstrating how to use scikit-build and scikit-build-core
+    to build Python extensions with CMake across a range of use cases.
+  github: https://github.com/scikit-build/scikit-build-sample-projects

hugo.toml

@@ -10,6 +10,18 @@ theme = 'github.com/adityatelange/hugo-PaperMod'
   ShowShareButtons = false
   ShowPostNavLinks = false
   hideMeta = true
+  defaultTheme = "auto"
+
+  [params.assets]
+    favicon = "/favicon.png"
+    favicon16x16 = "/favicon.png"
+    favicon32x32 = "/favicon.png"
+    apple_touch_icon = "/favicon.png"
+
+  [params.label]
+    text = ""
+    icon = "images/scikit_build_mark.svg"
+    iconHeight = 36
 
   [params.homeInfoParams]
     Title = "scikit-build"

layouts/index.html

@@ -1,6 +1,12 @@
 {{- define "main" }}
 <div class="home-hero">
-  <h1 class="home-hero-title">scikit-build</h1>
+  <img
+    class="home-hero-logo"
+    src="/images/scikit_build_logo.svg"
+    alt="scikit-build"
+    width="420"
+    height="95"
+  />
   <p class="home-hero-subtitle">
     An ecosystem of tools for building Python packages with compiled extensions —
     especially those powered by <a href="https://cmake.org/">CMake</a>.
@@ -13,7 +19,10 @@ <h1 class="home-hero-title">scikit-build</h1>
       GitHub
     </a>
     <a class="home-btn home-btn-secondary" href="https://scikit-build-core.readthedocs.io/">
-      Documentation
+      Documentation (core)
+    </a>
+    <a class="home-btn home-btn-secondary" href="https://scikit-build.readthedocs.io/">
+      Documentation (classic)
     </a>
   </div>
 </div>
@@ -22,11 +31,11 @@ <h1 class="home-hero-title">scikit-build</h1>
   <h2 class="projects-section-title">Projects</h2>
   <div class="projects-grid">
     {{- range hugo.Data.projects }}
-    <a class="project-card{{ if .primary }} project-card-primary{{ end }}" href="{{ .github }}" target="_blank" rel="noopener noreferrer">
+    <a class="project-card" href="{{ .github }}" target="_blank" rel="noopener noreferrer">
       <div class="project-card-header">
         <h3 class="project-card-name">{{ .name }}</h3>
-        {{- if .primary }}
-        <span class="project-card-badge">Core</span>
+        {{- range .labels }}
+        <span class="project-card-badge">{{ . }}</span>
         {{- end }}
       </div>
       <p class="project-card-description">{{ .description }}</p>