feat: add local GitHub Pages dev support

init.sh now generates plugin.yaml (via helm template)
and copies pages/index.html into backend/static/ so
the running Go backend serves the landing page locally.

Also adds helm prerequisite check, extracts PLUGIN_NAME
variable, simplifies README dev setup docs, and adds
CRC host mapping for macOS containers.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: dsimansk

.gitignore

@@ -53,3 +53,5 @@ install-state.gz
 # Built binaries
 /bin
 pages/plugin.yaml
+backend/static/index.html
+backend/static/plugin.yaml

README.md

@@ -44,63 +44,37 @@ Available image tags are listed in the [container registry](https://github.com/f
 
 - [Node.js](https://nodejs.org/en/) (v18+)
 - [Yarn](https://yarnpkg.com) (v4)
+- [Go](https://go.dev/dl/) (v1.24+)
+- [Helm](https://helm.sh/docs/intro/install/)
 - [oc](https://console.redhat.com/openshift/downloads) CLI
 - [Docker](https://www.docker.com) or [podman 3.2.0+](https://podman.io)
 - An [OpenShift cluster](https://console.redhat.com/openshift/create)
 - Github [*Personal Access Token*](https://github.com/settings/personal-access-tokens) with *administration*, *content* and *workflow* write permissions in all repositories
 - [inotify-tools](https://github.com/inotify-tools/inotify-tools) (optional, enables Go backend auto-recompile on file changes)
 
-### Option 1: Local
+### Setup
 
-In one terminal window, run:
+1. `oc login` to your OpenShift cluster
+2. `yarn install`
+3. `./init.sh`
 
-1. `yarn install`
-2. `yarn run start`
+This builds the pages assets (plugin.yaml, landing page), compiles the Go backend, starts the webpack dev server, and launches the OpenShift console in a container. Navigate to <http://localhost:9000> to see the running plugin.
 
-In another terminal window, run:
+To stop the dev environment:
 
-1. `oc login` (requires [oc](https://console.redhat.com/openshift/downloads) and an [OpenShift cluster](https://console.redhat.com/openshift/create))
-2. `yarn run start-console` (requires [Docker](https://www.docker.com) or [podman 3.2.0+](https://podman.io))
-
-This will run the OpenShift console in a container connected to the cluster
-you've logged into. The plugin HTTP server runs on port 9001 with CORS enabled.
-Navigate to <http://localhost:9000/example> to see the running plugin.
-
-#### Running start-console with Apple silicon and podman
-
-If you are using podman on a Mac with Apple silicon, `yarn run start-console`
-might fail since it runs an amd64 image. You can workaround the problem with
-[qemu-user-static](https://github.com/multiarch/qemu-user-static) by running
-these commands:
-
-```bash
-podman machine ssh
-sudo -i
-rpm-ostree install qemu-user-static
-systemctl reboot
+```shell
+./init.sh --stop
 ```
 
-### Option 2: Docker + VSCode Remote Container
+To use random ports (useful when defaults are already in use):
 
-Make sure the
-[Remote Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
-extension is installed. This method uses Docker Compose where one container is
-the OpenShift console and the second container is the plugin. It requires that
-you have access to an existing OpenShift cluster. After the initial build, the
-cached containers will help you start developing in seconds.
-
-1. Create a `dev.env` file inside the `.devcontainer` folder with the correct values for your cluster:
-
-```bash
-OC_PLUGIN_NAME=console-functions-plugin
-OC_URL=https://api.example.com:6443
-OC_USER=kubeadmin
-OC_PASS=<password>
+```shell
+./init.sh --randomize-ports
 ```
 
-2. `(Ctrl+Shift+P) => Remote Containers: Open Folder in Container...`
-3. `yarn run start`
-4. Navigate to <http://localhost:9000/example>
+### Viewing GitHub Pages locally
+
+The landing page served at [functions-dev.github.io/ocp-console-plugin](https://functions-dev.github.io/ocp-console-plugin/) is built from `pages/index.html` and the Helm chart. The `init.sh` script generates these assets into `backend/static/` automatically, so the running backend serves them at <http://localhost:8080>.
 
 ## Docker image
 

docs/claude-progress.txt

@@ -1,6 +1,19 @@
 # Claude Progress Log
 # Newest entries first. Agents: append your entry at the top after the header.
 
+---
+## 2026-06-15 | Session: GitHub Pages local dev (SRVOCF-843)
+Worked on: Review and polish existing local pages dev implementation
+Completed:
+- Reviewed changes on pr/page-cmd branch (build_pages in init.sh, README simplification, CRC host mapping, .gitignore updates)
+- Ran pre-commit code review (idiomatic shell, DRY, SOLID, build verification)
+- Extracted PLUGIN_NAME variable in init.sh to replace 3 hardcoded "console-functions-plugin" strings in build_pages()
+- Added features.json entry for SRVOCF-843
+- Confirmed error handling already covered by set -euo pipefail
+- All 14 suites, 126 tests passing, webpack builds clean
+Left off: Changes committed on pr/page-cmd branch, not pushed. Feature passes field still false (needs manual verification).
+Blockers: None
+
 ---
 ## 2026-05-21 | Session: Page co-location restructure (continued)
 Worked on: Follow-up fixes from review, test cleanup, docs

docs/features.json

@@ -180,5 +180,16 @@
       "All tests pass, no broken imports"
     ],
     "passes": true
+  },
+  {
+    "category": "technical",
+    "description": "GitHub Pages local development: script to generate plugin.yaml and serve the pages site locally",
+    "steps": [
+      "Add a script (e.g. hack/pages-dev.sh) that runs helm template to generate plugin.yaml into pages/",
+      "Script starts a local HTTP server (e.g. python -m http.server) to serve pages/ so fetch('plugin.yaml') works",
+      "Add pages/plugin.yaml to .gitignore so the generated file is not committed",
+      "Document usage in README or script header"
+    ],
+    "passes": false
   }
 ]

init.sh

@@ -3,6 +3,7 @@
 set -euo pipefail
 
 LOG_DIR=".dev-logs"
+PLUGIN_NAME="console-functions-plugin"
 CONSOLE_IMAGE="${CONSOLE_IMAGE:="quay.io/openshift/origin-console:latest"}"
 BACKEND_PORT=8080
 PLUGIN_PORT=9001
@@ -75,7 +76,17 @@ write_dev_env() {
 EOF
 }
 
+build_pages() {
+  echo "Building pages assets..."
+  helm template "$PLUGIN_NAME" charts/openshift-console-plugin \
+    -n "$PLUGIN_NAME" \
+    --set "plugin.image=ghcr.io/functions-dev/${PLUGIN_NAME}:latest" \
+    > backend/static/plugin.yaml
+  cp pages/index.html backend/static/index.html
+}
+
 start_backend() {
+  build_pages
   echo "Building Go backend..."
   (cd backend && go build -buildvcs=false -o ../bin/backend .)
   (cd backend && go build -buildvcs=false -o ../bin/errserver ./cmd/errserver)
@@ -176,6 +187,11 @@ check_prerequisites() {
     echo "Error: not logged in to OpenShift. Run 'oc login' first."
     exit 1
   fi
+
+  if ! command -v helm &>/dev/null; then
+    echo "Error: helm not found. Install from https://helm.sh/docs/intro/install/"
+    exit 1
+  fi
 }
 
 install_dependencies() {

start-console.sh

@@ -63,6 +63,9 @@ else
     PLUGIN_HOST="host.docker.internal"
 fi
 CONTAINER_NETWORK_OPTS="-p ${CONSOLE_PORT}:9000"
+if [[ "$(uname -s)" == "Darwin" ]]; then
+    CONTAINER_NETWORK_OPTS="${CONTAINER_NETWORK_OPTS} --add-host api.crc.testing:host-gateway"
+fi
 
 BRIDGE_PLUGINS="${PLUGIN_NAME}=http://${PLUGIN_HOST}:${PLUGIN_PORT}"
 BRIDGE_PLUGIN_PROXY='{"services":[{"consoleAPIPath":"/api/proxy/plugin/'"${PLUGIN_NAME}"'/backend/","endpoint":"http://'"${PLUGIN_HOST}"':'"${BACKEND_PORT}"'","authorize":false}]}'