ReactFinland · bebraw · Apr 3, 2026 · Apr 3, 2026 · Apr 3, 2026 · Apr 3, 2026
diff --git a/.assetsignore b/.assetsignore
@@ -0,0 +1,8 @@
+*
+!media/
+!media/**/
+!media/**/*.ico
+!media/**/*.jpeg
+!media/**/*.jpg
+!media/**/*.png
+!media/**/*.svg
diff --git a/.env.template b/.env.template
@@ -1 +1,2 @@
-TITO_TOKEN=<get from https://api.tito.io/>
+# Required API token for all non-media routes. Send it in the `TOKEN` header.
+TOKEN=
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  quality-fast:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: package.json
+          cache: npm
+
+      - name: Install dependencies
+        shell: bash
+        run: npm ci
+
+      - name: Run fast quality gate
+        shell: bash
+        run: npm run quality:gate:fast
diff --git a/.gitignore b/.gitignore
@@ -5,6 +5,9 @@ node_modules/
 logs/
 attendees/
 build/
+.wrangler/
+.wrangler-dry-run/
+.npm/
 server/types/
 media/scripts/
 utils/*.csv
@@ -13,4 +16,3 @@ utils/diversity-*
 .env
 .fusebox
 .scripts
-
diff --git a/.npmrc b/.npmrc
@@ -0,0 +1 @@
+save-exact=true
diff --git a/.nvmrc b/.nvmrc
@@ -1 +1 @@
-v22
+v24.14.1
diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
@@ -0,0 +1,41 @@
+# Development
+
+## Local development
+
+Use the Worker runtime for local development:
+
+1. Use Node.js 24, for example with `nvm use`.
+2. Install dependencies with `npm install`.
+3. Authenticate Wrangler with `npx wrangler login`.
+4. Start the Worker locally with `npm run cf:dev`.
+
+Wrangler uses [wrangler.jsonc](/Users/juhovepsalainen/Projects/future-frontend/graphql-api/wrangler.jsonc) and serves public image assets from the repository through the static-assets configuration in [.assetsignore](/Users/juhovepsalainen/Projects/future-frontend/graphql-api/.assetsignore).
+
+Useful local endpoints:
+
+- `http://localhost:8787/calendar-2026.ics`
+- `http://localhost:8787/media/people/kenw.jpg`
+
+## Quality checks
+
+Before deploying or after larger refactors, run:
+
+```sh
+npm run quality:gate
+```
+
+That executes the checked-in CI workflow locally through `agent-ci`.
+
+If you only want the direct checks without the local CI wrapper, run:
+
+```sh
+npm run quality:gate:fast
+```
+
+## Environment variables
+
+The application requires a `TOKEN` value at runtime for protected Worker-handled routes. `/calendar-2026.ics` and `/media/*` are public.
+
+For local Wrangler development, provide the values in `.dev.vars` or `.env`. The example in [.env.template](/Users/juhovepsalainen/Projects/future-frontend/graphql-api/.env.template) is:
+
+- `TOKEN` for authenticating protected Worker-handled routes through a `TOKEN` request header
diff --git a/Procfile b/Procfile
diff --git a/README.md b/README.md
@@ -1,30 +1,57 @@
 # GraphQL API for TOSKA conferences
 
-Simple GraphQL API for our conferences:
+This repository serves conference data over GraphQL and exposes a small set of supporting routes:
 
-To see the query API:
+- `/graphql`
+- `/ping`
+- `/calendar-2026.ics`
+- `/media/*`
 
-1. `NODE_ENV="development" npm start`
-2. `http://localhost:3000/graphql` or `http://localhost:3000/calendar-2022.ics` (calendar)
+Development setup lives in [DEVELOPMENT.md](/Users/juhovepsalainen/Projects/future-frontend/graphql-api/DEVELOPMENT.md).
 
-## Asset Designer
+## Deploying to Cloudflare
 
-You can access the asset designer through `http://localhost:3000/asset-designer`.
+### Prerequisites
 
-## Image Processing
+- A Cloudflare account with Workers enabled
+- Node.js 24 and npm installed
+- Dependencies installed with `npm install`
+- Wrangler authenticated with `npx wrangler login`
+- A `TOKEN` secret configured for the Worker
 
-There's no special image processing in place at the moment.
+### Configure the Worker
 
-> You can access images through `http://localhost:3000/media`. Example: `http://localhost:3000/media/people/kenw.jpg`.
+The project already includes a Worker entrypoint at [worker/index.ts](/Users/juhovepsalainen/Projects/future-frontend/graphql-api/worker/index.ts) and a Wrangler configuration at [wrangler.jsonc](/Users/juhovepsalainen/Projects/future-frontend/graphql-api/wrangler.jsonc).
 
-## Webhooks
+The current configuration:
 
-See the webhooks below.
+- runs a fetch-native request handler in Cloudflare Workers
+- routes `/graphql`, `/ping`, and `/calendar-2026.ics` through the Worker
+- serves only image files under `/media/*` from static assets in the repository
+- reuses a cached Worker handler per isolate instead of rebuilding the schema on each request
+- emits structured console logs with Cloudflare Workers observability enabled
 
-### Heroku to Netlify
+If you want a different Worker name, change the `name` field in `wrangler.jsonc`.
+Set the runtime token before deploy with `npx wrangler secret put TOKEN`.
+For local Worker development, provide the same value in `.dev.vars` or `.env` so Wrangler can load it into the Worker `env` bindings.
 
-The API has been connected to the site using a webhook so that it builds whenever the API changes:
+### Deploy
 
-- `heroku config:set REBUILD_SITES=<Netlify urls separate by comma go here> -a react-finland-api`
+Run:
 
-> Remember to run the server in production mode. That will enable site rebuilding hook!
+```sh
+npm run cf:deploy
+```
+
+That executes `npx wrangler deploy` using the checked-in configuration.
+
+### Verify after deploy
+
+Check these endpoints on the deployed domain:
+
+- `/graphql`
+- `/ping`
+- `/calendar-2026.ics`
+- `/media/people/kenw.jpg`
+
+Note that the first two require a `TOKEN` header.
diff --git a/add-compiled-to-git.sh b/add-compiled-to-git.sh
diff --git a/app.json b/app.json
diff --git a/content/freezing-edge-2020/index.ts b/content/freezing-edge-2020/index.ts
@@ -1,7 +1,7 @@
 import { Conference } from "../../server/schema/Conference";
-import * as locations from "../locations";
-import * as people from "../people";
-import * as allSponsors from "../sponsors";
+import { locations } from "../generated";
+import { people } from "../generated";
+import { sponsors as allSponsors } from "../generated";
 import schedules from "./schedules";
 
 const partners = [allSponsors.reactFinland, allSponsors.survivejs];

diff --git a/content/freezing-edge-2020/schedules.ts b/content/freezing-edge-2020/schedules.ts
@@ -1,8 +1,7 @@
 import { Schedule } from "../../server/schema/Schedule";
 import { SessionType } from "../../server/schema/Session";
-import * as locations from "../locations";
-// import * as people from "../people";
-import * as talks from "./talks";
+import { freezingEdge2020Talks as talks, locations } from "../generated";
+// import { people } from "../generated";
 
 const presentationDay: Schedule = {
   day: "2020-06-01",

diff --git a/content/freezing-edge-2020/talks/.index-modules b/content/freezing-edge-2020/talks/.index-modules
diff --git a/content/freezing-edge-2020/talks/index.ts b/content/freezing-edge-2020/talks/index.ts
diff --git a/content/future-frontend-2023/index.ts b/content/future-frontend-2023/index.ts
@@ -1,7 +1,7 @@
 import { Conference } from "../../server/schema/Conference";
-import * as locations from "../locations";
-import * as people from "../people";
-import * as allSponsors from "../sponsors";
+import { locations } from "../generated";
+import { people } from "../generated";
+import { sponsors as allSponsors } from "../generated";
 import schedules from "./schedules";
 
 const partners = [

diff --git a/content/future-frontend-2023/schedules.ts b/content/future-frontend-2023/schedules.ts
@@ -1,7 +1,7 @@
 import { Schedule } from "../../server/schema/Schedule";
 import { Level, SessionType } from "../../server/schema/Session";
-import * as locations from "../locations";
-import * as people from "../people";
+import { locations } from "../generated";
+import { people } from "../generated";
 
 const monday: Schedule = {
   day: "2023-06-05",

diff --git a/content/future-frontend-2024/index.ts b/content/future-frontend-2024/index.ts
@@ -1,7 +1,7 @@
 import { Conference } from "../../server/schema/Conference";
-import * as locations from "../locations";
-import * as people from "../people";
-import * as allSponsors from "../sponsors";
+import { locations } from "../generated";
+import { people } from "../generated";
+import { sponsors as allSponsors } from "../generated";
 import schedules from "./schedules";
 
 const partners = [

diff --git a/content/future-frontend-2024/schedules.ts b/content/future-frontend-2024/schedules.ts
@@ -1,8 +1,8 @@
 import { Schedule } from "../../server/schema/Schedule";
 import Keyword from "../../server/schema/keywords";
 import { Level, SessionType } from "../../server/schema/Session";
-import * as locations from "../locations";
-import * as people from "../people";
+import { locations } from "../generated";
+import { people } from "../generated";
 
 /*
 const monday: Schedule = {

diff --git a/content/future-frontend-2025/index.ts b/content/future-frontend-2025/index.ts
@@ -1,7 +1,7 @@
 import { Conference } from "../../server/schema/Conference";
-import * as locations from "../locations";
-import * as people from "../people";
-import * as allSponsors from "../sponsors";
+import { locations } from "../generated";
+import { people } from "../generated";
+import { sponsors as allSponsors } from "../generated";
 import schedules from "./schedules";
 
 const partners = [

diff --git a/content/future-frontend-2025/schedules.ts b/content/future-frontend-2025/schedules.ts
@@ -1,8 +1,8 @@
 import { Schedule } from "../../server/schema/Schedule";
 import Keyword from "../../server/schema/keywords";
 import { Level, SessionType } from "../../server/schema/Session";
-import * as locations from "../locations";
-import * as people from "../people";
+import { locations } from "../generated";
+import { people } from "../generated";
 
 // All times are given in GMT+0 (adjusted to GMT+3 at the frontend)
 const monday: Schedule = {

diff --git a/content/future-frontend-2026/index.ts b/content/future-frontend-2026/index.ts
@@ -1,8 +1,8 @@
 import { Conference } from "../../server/schema/Conference";
 import { Contact } from "../../server/schema/Contact";
-import * as locations from "../locations";
-import * as people from "../people";
-import * as allSponsors from "../sponsors";
+import { locations } from "../generated";
+import { people } from "../generated";
+import { sponsors as allSponsors } from "../generated";
 import schedules from "./schedules";
 
 const partners: Contact[] = [

diff --git a/content/future-frontend-2026/schedules.ts b/content/future-frontend-2026/schedules.ts
@@ -1,8 +1,8 @@
 import { Schedule } from "../../server/schema/Schedule";
 import Keyword from "../../server/schema/keywords";
 import { Level, SessionType } from "../../server/schema/Session";
-import * as locations from "../locations";
-import * as people from "../people";
+import { locations } from "../generated";
+import { people } from "../generated";
 
 // All times are given in GMT+0 (adjusted to GMT+3 at the frontend)
 const monday: Schedule = {