Skip to content

PrimerPages/primerpages-minimal

Repository files navigation

layout profile
posts_limit 3

PrimerPages Minimal Template (GitHub Actions Deploy)

Use this template when you want to publish with GitHub Actions (artifact deploy to Pages), while keeping a minimal plugin surface.

Contributing

This template is maintained in primerpages-dev.

  • Source repo: PrimerPages/primerpages-dev
  • Please open issues and pull requests there, not in the generated template repository.

What This Template Is For

  • theme: jekyll-theme-profile in _config.yml
  • A starter site structure (index.md, blog/, tags/, docs, and sample posts)
  • A Pages deployment workflow at .github/workflows/site.yml

Quick Setup

  1. Create a new repository from this template.
  2. Update _config.yml:
    • title
    • description
    • repository (set to OWNER/REPO)
  3. Commit and push to your default branch (main by default).
  4. In GitHub, go to Settings -> Pages.
  5. Under Build and deployment, set:
    • Source: GitHub Actions
  6. Let the workflow run and deploy the site.

How Deploy Works

  • On pushes to main (or manual dispatch), the workflow:
    • builds the site with Jekyll,
    • uploads _site as a Pages artifact,
    • deploys with actions/deploy-pages.

Verify It Works

  • Visit https://<owner>.github.io/<repo>/ for project pages.
  • Confirm this home page renders and nav links work.
  • Open /debug to inspect active Jekyll/theme info.

Reference

About

Template repository for minimal primer pages setup

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors