Infomap Online

Infomap Online is a client-side web application for running Infomap in the browser without any local installation. All computation runs on the user's machine; no network data is uploaded to a server. The browser runtime is built from the native Infomap code with Emscripten, so it is slower than the standalone CLI.

The JavaScript web worker used by this site is published as @mapequation/infomap.

The public site lives at mapequation.org/infomap.

Development

This repository targets Node.js 20 and npm.

nvm use
npm ci
npm run dev

Verification

Run the same checks locally as in CI:

npx playwright install chromium
npm run verify

CI/CD

• CI runs on every push and pull request. It installs dependencies, runs lint and typecheck, builds the static export, and executes the Playwright smoke test against the exported site.
• Deploy runs after a successful CI run on master and deploys the tested out/ artifact over SSH with rsync --delete.
• Update @mapequation/infomap listens for a repository_dispatch event from the infomap repository, pins the new package version, verifies the app, and opens a PR.

Required configuration for infomap-online:

• Secrets: SSH_HOST, SSH_USER, SSH_KEY, SSH_KNOWN_HOSTS
• Optional secret: SSH_PORT
• Optional repository variable: DEPLOY_BASE_URL

Required configuration for infomap:

• Secret: INFOMAP_ONLINE_REPO_DISPATCH_TOKEN

Authors

Daniel Edler, Anton Holmgren, Martin Rosvall