rafgraph/spa-github-pages resource

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

4036 stars · 565 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A lightweight boilerplate solution for hosting single page apps on GitHub Pages, which doesn't natively support client-side routing. It uses a custom 404.html redirect trick to convert frontend routes into query strings so deep links load correctly.

Use cases

• deploy a react router spa on github pages
• fix 404 errors on page refresh for frontend routes
• host single page app with client-side routing on github pages
• support deep links in a static site on github pages
• serve index.html for all routes on github pages

When to choose

• you're hosting a SPA on GitHub Pages and need BrowserRouter-style routing to work on fresh page loads
• you want a zero-dependency, copy-paste fix rather than a build tool or server

When to avoid

• you can use a host with native SPA fallback support like Netlify or Vercel
• your site is server-rendered or uses hash-based routing
• you need server-side logic or custom headers

Facets

learning-resource · maturity maintenance

routing deployment web-framework web-development frontend developer-tools browser cross-platform github-pages spa static-hosting client-side-routing 404-redirect boilerplate web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="rafgraph/spa-github-pages")