feat: Add metadata for Hugo, add workflow and update README with screenshots

Signed-off-by: Felicitas Pojtinger <felicitas@pojtinger.com>

Author: pojntfx

.github/workflows/hugo.yaml

@@ -0,0 +1,90 @@
+# Based on https://gohugo.io/host-and-deploy/host-on-github-pages/#article
+
+name: Hugo CI
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+concurrency:
+  group: pages
+  cancel-in-progress: false
+defaults:
+  run:
+    shell: bash
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      DART_SASS_VERSION: 1.98.0
+      HUGO_VERSION: 0.158.0
+      NODE_VERSION: 24.14.0
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Create directory for user-specific executable files
+        run: |
+          mkdir -p "${HOME}/.local"
+      - name: Install Dart Sass
+        run: |
+          curl -sLJO "https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
+          tar -C "${HOME}/.local" -xf "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
+          rm "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
+          echo "${HOME}/.local/dart-sass" >> "${GITHUB_PATH}"
+      - name: Install Hugo
+        run: |
+          curl -sLJO "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
+          mkdir "${HOME}/.local/hugo"
+          tar -C "${HOME}/.local/hugo" -xf "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
+          rm "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
+          echo "${HOME}/.local/hugo" >> "${GITHUB_PATH}"
+      - name: Install Node.js dependencies
+        run: |
+          [[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true
+      - name: Cache restore
+        id: cache-restore
+        uses: actions/cache/restore@v5
+        with:
+          path: ${{ runner.temp }}/hugo_cache
+          key: hugo-${{ github.run_id }}
+          restore-keys: hugo-
+      - name: Build the site
+        run: |
+          hugo build \
+            --gc \
+            --minify \
+            --baseURL "${{ steps.pages.outputs.base_url }}/" \
+            --cacheDir "${{ runner.temp }}/hugo_cache"
+      - name: Cache save
+        id: cache-save
+        uses: actions/cache/save@v5
+        with:
+          path: ${{ runner.temp }}/hugo_cache
+          key: ${{ steps.cache-restore.outputs.cache-primary-key }}
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./public
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,4 @@
+public/
+resources/
+.hugo_build.lock
+node_modules/

CNAME

@@ -1,13 +1,78 @@
 # vanlug.ca
 
-Website for the Vancouver Linux Users Group
+Website for the Vancouver Linux Users Group.
+
+[![Hugo CI](https://github.com/vanlug/vanlug.github.io/actions/workflows/hugo.yaml/badge.svg)](https://github.com/vanlug/vanlug.github.io/actions/workflows/hugo.yaml)
+![Go Version](https://img.shields.io/badge/go%20version-%3E=1.25-61CFDD.svg)
+[![Go Reference](https://pkg.go.dev/badge/github.com/vanlug/vanlug.github.io.svg)](https://pkg.go.dev/github.com/vanlug/vanlug.github.io)
 
 ## Overview
 
-🚧 This project is a work-in-progress! Instructions will be added as soon as it is usable. 🚧
+VanLUG is a non-profit user group for Linux professionals, hobbyists, and curious newcomers in the Greater Vancouver area, incorporated in 1999. The site is built with Hugo and PatternFly v6.
+
+It provides the following:
+
+- Home page with next meeting card (fetched from Luma API via a proxy hosted on Railway), "what to expect" cards, and social links
+- Events page with embedded Luma calendar iframe and full past event history
+- About page with mission, purpose mandates, and board of directors
+- Partners page listing library and community venue partners
+- Resources page with speaker slides, AGM documents, learning links, and design system
+- Membership page with benefits and registration link (Luma)
+- Code of Conduct, Terms of Service, and Privacy Policy pages
+- Donate card and land acknowledgment in the footer
+
+The site is accessible at [https://vanlug.ca/](https://vanlug.ca/).
+
+## Screenshots
+
+Click on an image to see a larger version.
+
+<a display="inline" href="./docs/home.png?raw=true">
+<img src="./docs/home.png" width="45%" alt="Screenshot of the home page" title="Screenshot of the home page">
+</a>
+
+<a display="inline" href="./docs/events.png?raw=true">
+<img src="./docs/events.png" width="45%" alt="Screenshot of the events page" title="Screenshot of the events page">
+</a>
+
+<a display="inline" href="./docs/about.png?raw=true">
+<img src="./docs/about.png" width="45%" alt="Screenshot of the about page" title="Screenshot of the about page">
+</a>
+
+<a display="inline" href="./docs/resources.png?raw=true">
+<img src="./docs/resources.png" width="45%" alt="Screenshot of the resources page" title="Screenshot of the resources page">
+</a>
+
+<a display="inline" href="./docs/partners.png?raw=true">
+<img src="./docs/partners.png" width="45%" alt="Screenshot of the partners page" title="Screenshot of the partners page">
+</a>
+
+<a display="inline" href="./docs/membership.png?raw=true">
+<img src="./docs/membership.png" width="45%" alt="Screenshot of the membership page" title="Screenshot of the membership page">
+</a>
+
+## Acknowledgements
+
+- [gohugoio/hugo](https://github.com/gohugoio/hugo) provides the static site generator.
+- The open source [PatternFly design system](https://www.patternfly.org/) provides the UI components.
+- [FortAwesome/Font-Awesome](https://github.com/FortAwesome/Font-Awesome) provides the icons.
+- [lu.ma](https://lu.ma/) provides the event calendar and API.
+
+## Contributing
+
+To contribute, please use the [GitHub flow](https://guides.github.com/introduction/flow/) and follow our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+To build the site locally, run:
+
+```shell
+$ git clone https://github.com/vanlug/vanlug.github.io.git
+$ cd vanlug.github.io
+$ npm install
+$ hugo server
+```
 
 ## License
 
-vanlug.ca (c) 2026 Felicitas Pojtinger
+vanlug.ca (c) 2026 Felicitas Pojtinger and contributors
 
 SPDX-License-Identifier: AGPL-3.0