This is a minimal static website you can deploy to GitHub Pages. It includes a .nojekyll file so GitHub won't try to build with Jekyll.
- Put your images (JPG/PNG/WebP) into the
images/folder. - Edit
index.htmlto reference your image filenames. - (Optional) Edit styles in
styles.css.
Deploy from branch (no Actions):
- Create a new GitHub repo and upload these files to the repository root.
- Go to Settings → Pages → Build and deployment → set Source to Deploy from a branch.
- Choose branch
mainand folder/ (root)→ Save. - Your site will be served without Jekyll processing due to the
.nojekyllfile.
Optional: GitHub Actions workflow
If you prefer Actions, create .github/workflows/pages.yml with:
name: Deploy static site to Pages
on:
push:
branches: [ "main" ]
workflow_dispatch:
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: "pages"
cancel-in-progress: true
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/upload-pages-artifact@v3
with:
path: .
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- id: deployment
uses: actions/deploy-pages@v4Then enable Pages (Settings → Pages).
- Make sure
index.htmlis at the repo root (not inside a subfolder). - Avoid folder names starting with
_(e.g.,_images) when not using.nojekyll—Jekyll would skip them. - Filenames are case-sensitive on the web.
- If images don't show on your project page (not user site), remember the base path is
/<repo-name>/.