vis.gl

This repository contains the vis.gl website. It is a statically exported Next.js site deployed by Netlify.

The existing framework catalog, showcases, news, blog, and project history are retained here. Open Visualization provides the broader collaboration space's current community, governance, and event information.

Development

Use Node.js 22.22.1 or later and Yarn 4:

yarn install --immutable
yarn dev

Open http://localhost:3000. Run the complete validation suite with:

yarn check

Static deployment

yarn build exports the main website to out/. Netlify publishes that directory whenever the default branch is updated.

Project documentation

The static export can also host documentation built by another vis.gl project. Entries in project-sites.json may optionally build a project, then copy its static output into a path under out/.

math.gl and probe.gl are included as pinned Git submodules at projects/math.gl and projects/probe.gl. Each project installs its own dependencies, builds its Docusaurus website with a canonical vis.gl URL, and mounts the result under /math.gl or /probe.gl.

{
  "sites": [
    {
      "name": "math.gl",
      "mountPath": "/math.gl",
      "source": "projects/math.gl/website/build",
      "build": [
        {
          "command": "git",
          "args": ["submodule", "update", "--init", "--recursive", "--", "projects/math.gl"]
        },
        {
          "cwd": "projects/math.gl",
          "command": "yarn",
          "args": ["install", "--immutable"]
        },
        {
          "cwd": "projects/math.gl/website",
          "command": "yarn",
          "args": ["docusaurus", "build", "--config", "../../../project-site-configs/math.gl.mjs"]
        }
      ]
    }
  ]
}

The probe.gl entry follows the same pattern and additionally installs the website workspace before building it, since the probe.gl monorepo keeps the website lockfile separate.

Project builds must generate URLs and assets for their configured mount path. Sources, build directories, and mount paths are constrained to this repository and its out/ directory. /math and /probe permanently redirect to their canonical /math.gl/ and /probe.gl/ paths.