jongio/gh-pages-templates

GitHub Pages Templates

A registry of ready-to-deploy GitHub Pages starters. Each one ships the current GitHub Actions Pages workflow and the right base-path setup, so it deploys correctly to a user or project site with no fiddling.

Don't pick a template by hand — the /create-gh-pages-site Copilot skill generates a site tailored to your repo. It reads the repo you point it at (or the one you're working in) and wires the framework, base path, and deploy workflow to fit it.

1
Install the skill

Paste into Copilot chat — you only do this once:
```
install create-gh-pages-site from jongio/skills
```
2
Generate your site

Run it in the repo you want the site for, or point it at one with owner/name — Copilot customizes the result to that repo:
```
/create-gh-pages-site
```

Browse templates Other install options Submit a template

Loading templates…

Install the skill

These templates are scaffolded by the create-gh-pages-site GitHub Copilot skill, part of the jongio/skills collection. Install it once, then ask Copilot for any template — each card below shows the exact prompt.

Just ask Copilot

Paste this into the Copilot chat — it installs the skill for you:

install create-gh-pages-site from jongio/skills

Or by command

copilot plugin marketplace add jongio/skills
copilot plugin install create-gh-pages-site@jongio-skills

Or the skills CLI

# Global, for GitHub Copilot:
npx skills add jongio/skills --skill create-gh-pages-site -g --agent github-copilot

# …or into the current project instead (drop -g):
npx skills add jongio/skills --skill create-gh-pages-site

In the Copilot app: Settings → Plugins → Install ▾ → Add marketplace, enter jongio/skills, then install create-gh-pages-site. After installing, reload skills with /skills reload or start a new session.

Use a template

With Copilot — invoke /create-gh-pages-site with the prompt shown on each card, e.g. "an Astro site". It uses the current repo by default and asks for the framework or repo only if it's unclear.
Push to main, then set Settings → Pages → Source → GitHub Actions. The deploy workflow publishes on every push; the live URL appears in the Actions run.
The skill points the repo's Website link at the Pages URL for you — same as ticking "Use your GitHub Pages website".

Submit your own template

Anyone can add a template. A template is a folder under templates/<name>/ containing:

a template.json manifest (title, tier, framework, base-path mechanism, tags);
a .github/workflows/deploy.yml using the official GitHub Pages actions;
base-path handling via the __BASE_PATH__ / __BASE_URL__ sentinels;
a short README.md.

Fork jongio/gh-pages-templates and copy an existing template as a starting point.
Run node scripts/validate.mjs (checks manifests, workflows, and the generator stamp) and node scripts/build-site.mjs to preview locally.
Open a pull request. CI validates it; once merged, your template shows up here with a live preview automatically.

Read CONTRIBUTING.md →