feat: allow build-time metadata config for web library

Author: joonsoome

.env.stage.example

@@ -13,3 +13,9 @@ WEB_LIBRARY_PORT=8281
 
 # Base URL that the Web Library should use when linking to the PDF proxy (update to your staging hostname/IP)
 PDF_PROXY_BASE_URL=http://nas.local:8280/pdf
+
+# Optional: metadata source (used at build time for the Web Library image)
+ZOTERO_API_KEY=
+ZOTERO_API_AUTHORITY_PART=api.zotero.org
+ZOTERO_USER_SLUG=
+ZOTERO_USER_ID=

Dockerfile.web-library

@@ -10,7 +10,10 @@ COPY app/web-library-upstream/ /app/web-library-upstream/
 COPY app/web-library-overlay/ /app/web-library-overlay/
 
 # Apply overlay into a build directory
-RUN mkdir -p /app/web-library-build \
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends rsync gettext-base \
+    && rm -rf /var/lib/apt/lists/* \
+    && mkdir -p /app/web-library-build \
     && rsync -a /app/web-library-upstream/ /app/web-library-build/ \
     && if [ -d /app/web-library-overlay/src ]; then rsync -a /app/web-library-overlay/src/ /app/web-library-build/src/; fi \
     && if [ -d /app/web-library-overlay/config ]; then rsync -a /app/web-library-overlay/config/ /app/web-library-build/config/; fi
@@ -24,6 +27,20 @@ RUN git clone --depth 1 --recurse-submodules --shallow-submodules https://github
     && git clone --depth 1 --recurse-submodules --shallow-submodules https://github.com/zotero/web-common.git modules/web-common \
     && git clone --depth 1 --recurse-submodules --shallow-submodules https://github.com/zotero/zotero-schema.git modules/zotero-schema
 
+# Inject build-time metadata config for overlay (api key/authority, user slug/id, pdf proxy base)
+ARG ZOTERO_API_KEY=""
+ARG ZOTERO_API_AUTHORITY_PART="api.zotero.org"
+ARG ZOTERO_USER_SLUG=""
+ARG ZOTERO_USER_ID="0"
+ARG PDF_PROXY_BASE_URL="http://localhost:8280/pdf"
+ENV ZOTERO_API_KEY=$ZOTERO_API_KEY \
+    ZOTERO_API_AUTHORITY_PART=$ZOTERO_API_AUTHORITY_PART \
+    ZOTERO_USER_SLUG=$ZOTERO_USER_SLUG \
+    ZOTERO_USER_ID=$ZOTERO_USER_ID \
+    PDF_PROXY_BASE_URL=$PDF_PROXY_BASE_URL
+
+RUN envsubst < /app/web-library-overlay/src/html/index.html > /app/web-library-build/src/html/index.html
+
 # Build Web Library (combined subtree + overlay)
 RUN npm ci \
     && npm run build

README.md

@@ -180,6 +180,7 @@ The sample data generator creates keys like `SAMPLE1` and `SAMPLE2` under `sampl
 - `.env.stage.example` → `.env.stage`: staging/NAS stack via `docker compose --env-file .env.stage up -d` (defaults to GHCR `:main` tags).
 - `.env.portainer.example` → `.env.portainer`: Portainer stack env file (same vars as staging) when deploying through the UI.
 - `.env` remains ignored; keep real secrets/paths out of the repo.
+- Metadata config (build-time for Web Library): optional `ZOTERO_API_KEY`, `ZOTERO_API_AUTHORITY_PART`, `ZOTERO_USER_SLUG`, `ZOTERO_USER_ID` to point the Web Library at zotero.org or an on-prem metadata source. Set in your env file before building the Web Library image.
 
 ---
 

app/web-library-overlay/src/html/index.html

@@ -15,9 +15,13 @@
 	<div id="zotero-web-library"></div>
 	<script type="application/json" id="zotero-web-library-config">
 		{
-			"userSlug": "zotero-user",
-			"userId": "475425",
-			"pdfProxyBaseUrl": "http://localhost:8280/pdf",
+			"userSlug": "$ZOTERO_USER_SLUG",
+			"userId": "$ZOTERO_USER_ID",
+			"apiKey": "$ZOTERO_API_KEY",
+			"apiConfig": {
+				"apiAuthorityPart": "$ZOTERO_API_AUTHORITY_PART"
+			},
+			"pdfProxyBaseUrl": "$PDF_PROXY_BASE_URL",
 			"libraries": {
 				"include": [
 					{