Add Gatsby documentation website with GitHub Pages deployment

[Copilot]

Creates a static documentation website to organize 58+ markdown files for non-technical users, showcasing recent improvements and providing better discoverability than raw GitHub markdown.

Implementation

Website Structure (src/website/)

• Gatsby 5.13 static site generator with React 18
• Automatic page generation from markdown via GraphQL queries
• Categorized navigation: Core Docs, Guides (9), API Reference (23), Technical (15)
• Custom responsive CSS with grid layouts, no heavy frameworks

Pages

• Homepage: Feature overview, how-it-works guide, quick links
• Documentation index: Category-based organization with excerpts
• Getting Started: Installation paths by language
• Recent Improvements: Highlights Phase 2, Rust modernization, validation enforcement, test updates

Deployment

• GitHub Actions workflow: build on push to main, deploy to gh-pages branch
• Triggered by changes to src/website/** or docs/**
• Site URL: https://jaypatrick.github.io/ad-blocking

Build Output

• 66 pages generated (5 static + 61 from markdown)
• Path prefix configured for GitHub Pages subdirectory routing

Configuration

// gatsby-config.js - Sources docs from repository root
{
  resolve: `gatsby-source-filesystem`,
  options: {
    name: `docs`,
    path: `${__dirname}/../../docs`,
  },
}

// gatsby-node.js - Dynamic page generation
exports.createPages = async ({ graphql, actions }) => {
  const result = await graphql(`
    query {
      allMarkdownRemark {
        nodes {
          id
          fields { slug }
        }
      }
    }
  `)
  
  result.data.allMarkdownRemark.nodes.forEach(node => {
    createPage({
      path: node.fields.slug,
      component: docTemplate,
      context: { id: node.id }
    })
  })
}

Screenshots

Homepage - Feature overview with clear CTAs

Documentation - Organized by category with excerpts

Recent Improvements - Showcases modernization work

Updates

• README: Added website link and documentation section
• Project structure: Updated to include src/website/ directory

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• unpkg.com
  • Triggering command: /usr/local/bin/node node scripts/postinstall.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

We need to build a website via github pages, something that organizes the huge amount of .md files we have. The website would be geared more towards non-technical users, but it should showcase all of the improvements we've made over the last couple of weeks. A static generator is fine, something that is easy to maintain via git. What are your thoughts?

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.