Migrate website to Starlight with full-text resource search (#883)

* Add search functionality to Learning Hub index page

Add a client-side search bar that filters articles by title, description,
and tags. Sections with no matching results are hidden automatically.
Uses the existing .search-bar CSS pattern from the cookbook page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: remove deprecated layouts, theme script, and learning-hub config

Phase 5 cleanup of Starlight migration:
- Delete BaseLayout.astro (replaced by StarlightPage)
- Delete ArticleLayout.astro (replaced by Starlight docs rendering)
- Delete theme.ts (Starlight has built-in theme toggle)
- Delete src/config/learning-hub.ts (sidebar order now in astro.config.mjs)
- Replace learning-hub glob collection with Starlight docs collection in content.config.ts
- Keep search.ts (still used by homepage and all resource page scripts)

Build verified: 23 pages, no errors.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Migrate website to Starlight with full-text resource search

- Replace bespoke Astro layouts with Starlight integration
  - Homepage and resource pages use StarlightPage wrapper
  - Learning Hub articles rendered via Starlight docs collection
  - Starlight provides search, theme toggle, sidebar, ToC, a11y

- Add custom Pagefind integration for resource search
  - All 614 agents/skills/instructions/hooks/workflows/plugins
    indexed as custom records with deep-link URLs
  - Type filter pills (horizontal pill toggles) above results
  - Search results link directly to resource modals via #file= hash

- Move global.css to src/styles/ for Vite processing
  - Scope CSS reset to #main-content to avoid Starlight conflicts
  - Full-width page gradient via body:has(#main-content)
  - Light/dark theme support with Starlight gray scale inversion

- Delete old layouts (BaseLayout, ArticleLayout), theme.ts, config

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address PR review feedback

- Fix pagefind-resources.ts header comment (pagefind:true not false)
- Remove unused base variable in cookbook/index.astro
- Replace hardcoded /awesome-copilot/ paths with relative links in index.md
- Delete stale public/styles/global.css (source of truth is src/styles/)
- Replace fragile getBasePath() with Astro config base in pagefind integration
- Document pagefind:true reasoning in astro.config.mjs
- Use proper visually-hidden pattern + :focus-visible ring for filter pills
- Remove dead header/nav/theme CSS from global.css (~160 lines)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
Aaron Powell
2026-03-05 21:50:44 +11:00
committed by GitHub
parent 8fedf95507
commit 40fd1a6c72
50 changed files with 1891 additions and 888 deletions

View File

@@ -0,0 +1 @@
../../learning-hub/agentic-workflows.md

View File

@@ -0,0 +1 @@
../../learning-hub/automating-with-hooks.md

View File

@@ -0,0 +1 @@
../../learning-hub/before-after-customization-examples.md

View File

@@ -0,0 +1 @@
../../learning-hub/building-custom-agents.md

View File

@@ -0,0 +1 @@
../../learning-hub/copilot-configuration-basics.md

View File

@@ -0,0 +1 @@
../../learning-hub/creating-effective-skills.md

View File

@@ -0,0 +1 @@
../../learning-hub/defining-custom-instructions.md

View File

@@ -0,0 +1 @@
../../learning-hub/github-copilot-terminology-glossary.md

View File

@@ -0,0 +1,32 @@
---
title: Learning Hub
description: 'Curated articles, walkthroughs, and reference material to help you unlock everything you can do with GitHub Copilot'
template: splash
hero:
tagline: 'Curated articles, walkthroughs, and reference material to help you unlock everything you can do with GitHub Copilot'
actions:
- text: Start with Fundamentals
link: /learning-hub/what-are-agents-skills-instructions/
icon: right-arrow
sidebar:
hidden: true
tableOfContents: false
---
## Fundamentals
Essential concepts to tailor GitHub Copilot beyond its default experience. Start with
[What are Agents, Skills, and Instructions](/learning-hub/what-are-agents-skills-instructions/)
and work through the full track to master every customization primitive.
## Reference
Quick-lookup resources to keep handy while you work. Browse the
[GitHub Copilot Terminology Glossary](/learning-hub/github-copilot-terminology-glossary/)
for definitions of common terms and concepts.
## Hands-on
Interactive samples and recipes to learn by doing. Jump into the
[Cookbook](/learning-hub/cookbook/) for code samples, recipes,
and examples you can use right away.

View File

@@ -0,0 +1 @@
../../learning-hub/installing-and-using-plugins.md

View File

@@ -0,0 +1 @@
../../learning-hub/understanding-copilot-context.md

View File

@@ -0,0 +1 @@
../../learning-hub/understanding-mcp-servers.md

View File

@@ -0,0 +1 @@
../../learning-hub/using-copilot-coding-agent.md

View File

@@ -0,0 +1 @@
../../learning-hub/what-are-agents-skills-instructions.md

View File

@@ -3,7 +3,7 @@ title: 'Agentic Workflows'
description: 'Learn what GitHub Agentic Workflows are, how to use community workflows from Awesome Copilot, and how to contribute your own.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-27'
lastUpdated: 2026-02-27
estimatedReadingTime: '7 minutes'
tags:
- workflows

View File

@@ -3,7 +3,7 @@ title: 'Automating with Hooks'
description: 'Learn how to use hooks to automate lifecycle events like formatting, linting, and governance checks during Copilot agent sessions.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-26'
lastUpdated: 2026-02-26
estimatedReadingTime: '8 minutes'
tags:
- hooks

View File

@@ -3,7 +3,7 @@ title: 'Before/After Customization Examples'
description: 'See real-world transformations showing how custom agents, skills, and instructions dramatically improve GitHub Copilot effectiveness.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2025-12-12'
lastUpdated: 2025-12-12
estimatedReadingTime: '12 minutes'
tags:
- customization

View File

@@ -3,7 +3,7 @@ title: 'Building Custom Agents'
description: 'Learn how to create specialized GitHub Copilot agents with custom personas, tool integrations, and domain expertise.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-26'
lastUpdated: 2026-02-26
estimatedReadingTime: '10 minutes'
tags:
- agents

View File

@@ -3,7 +3,7 @@ title: 'Copilot Configuration Basics'
description: 'Learn how to configure GitHub Copilot at user, workspace, and repository levels to optimize your AI-assisted development experience.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2025-11-28'
lastUpdated: 2025-11-28
estimatedReadingTime: '10 minutes'
tags:
- configuration

View File

@@ -3,7 +3,7 @@ title: 'Creating Effective Skills'
description: 'Master the art of writing reusable, shareable skill folders that deliver consistent results across your team.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-26'
lastUpdated: 2026-02-26
estimatedReadingTime: '9 minutes'
tags:
- skills

View File

@@ -3,7 +3,7 @@ title: 'Defining Custom Instructions'
description: 'Learn how to create persistent, context-aware instructions that guide GitHub Copilot automatically across your codebase.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2025-12-02'
lastUpdated: 2025-12-02
estimatedReadingTime: '8 minutes'
tags:
- instructions

View File

@@ -3,7 +3,7 @@ title: 'GitHub Copilot Terminology Glossary'
description: 'A quick reference guide defining common GitHub Copilot and platform-specific terms.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2025-12-15'
lastUpdated: 2025-12-15
estimatedReadingTime: '8 minutes'
tags:
- glossary

View File

@@ -3,7 +3,7 @@ title: 'Installing and Using Plugins'
description: 'Learn how to find, install, and manage plugins that extend GitHub Copilot CLI with reusable agents, skills, hooks, and integrations.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-26'
lastUpdated: 2026-02-26
estimatedReadingTime: '8 minutes'
tags:
- plugins

View File

@@ -3,7 +3,7 @@ title: 'Understanding Copilot Context'
description: 'Learn how GitHub Copilot uses context from your code, workspace, and conversation to generate relevant suggestions.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2025-11-28'
lastUpdated: 2025-11-28
estimatedReadingTime: '8 minutes'
tags:
- context

View File

@@ -3,7 +3,7 @@ title: 'Understanding MCP Servers'
description: 'Learn how Model Context Protocol servers extend GitHub Copilot with access to external tools, databases, and APIs.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-26'
lastUpdated: 2026-02-26
estimatedReadingTime: '8 minutes'
tags:
- mcp

View File

@@ -3,7 +3,7 @@ title: 'Using the Copilot Coding Agent'
description: 'Learn how to use GitHub Copilot coding agent to autonomously work on issues, generate pull requests, and automate development tasks.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-26'
lastUpdated: 2026-02-26
estimatedReadingTime: '12 minutes'
tags:
- coding-agent

View File

@@ -3,8 +3,9 @@ title: 'What are Agents, Skills, and Instructions'
description: 'Understand the primary customization primitives that extend GitHub Copilot for specific workflows.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: '2026-02-26'
lastUpdated: 2026-02-26
estimatedReadingTime: '7 minutes'
prev: false
---
Building great experiences with GitHub Copilot starts with understanding the core primitives that shape how Copilot behaves in different contexts. This article clarifies what each artifact does, how it is packaged inside this repository, and when to use it.