Add gitlab-ci.yml pages templates for top SSGs

Problem to solve

Setting up a GitLab pages project is much easier if you have a template to follow. As part of the Experience Baselines and Recommendations initiative, it was determined the presence of a template can make the process much less daunting. There are a lot of static site generators and including templates for all of them would be challenging, but support for the most popular SSGs would provide the best chance for a positive experience for most users.

Current support for the 20 most popular static site generators as listed by https://www.staticgen.com/

SSG Create from template gitlab-ci.yml template Example project
HTML ✅ ✅ ✅
Next.js
Jekyll ✅ ✅ ✅
Hugo ✅ ✅ ✅
Gatsby ✅ ✅
Hexo ✅ ✅ ✅
Nuxt ✅
GitBook ✅ ✅
VuePress ✅
Docusaurus
Pelican ✅ ✅
MkDocs ✅
React Static
Metalsmith ✅ ✅
Brunch ✅ ✅
Middleman ✅ ✅
Harp ✅ ✅
Expose
Assemble
Gridsome

Intended users

Users with projects that use any static website generator or plain HTML that wish to leverage GitLab pages.

Proposal

For the top static site generators, add templates to the gitlab-ci.yml templates.

  • Next.js
  • Nuxt
  • Gitbook
  • VuePress

Links / references

Experience Baselines and Recommendations

Experience Baselines and Recommendation: Release Q2

Assignee Loading
Time tracking Loading