Skip to content

Make it easy to deploy TerriaMap to GH Pages#774

Open
meiqimichelle wants to merge 2 commits intomainfrom
easier-ghpages-deploys
Open

Make it easy to deploy TerriaMap to GH Pages#774
meiqimichelle wants to merge 2 commits intomainfrom
easier-ghpages-deploys

Conversation

@meiqimichelle
Copy link
Copy Markdown

@meiqimichelle meiqimichelle commented Mar 30, 2026

We got a few notes from #773 about speedbumps when trying to deploy a TerriaMap to GitHub Pages.

This PR makes two changes to (hopefully) make this process a little more straightforward for future travelers. It:

  1. Adds the packageManager field to package.json and pins yarn@1.22.22 so that Corepack can manage it automatically.

  2. Adds a GitHub Pages deployment workflow to this repo that uses Corepack (no npm dependency), our existing --baseHref gulp flag, and GitHub's official Pages deployment actions. Triggers on push to main (or manual dispatch).

Forks can enable GitHub Pages in their repo settings and this workflow will handle the rest.

Note: for this to work in this repo, we also need to check our settings. We'd need:

  • Settings → Pages → Source -- set to "GitHub Actions" (not "Deploy from a branch")
  • Settings → Actions → General -- workflow permissions would need to allow Pages deployment
  • [EDIT: ...and also enable GitHub Pages, if it isn't already enabled]

There may be Reasons some or all of this is not a good idea. Feedback welcome.

@meiqimichelle meiqimichelle requested review from na9da and zoran995 March 30, 2026 04:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant