Aperture FITS Image Lab

The interactive browser demo for zigfitsio, a pure-Zig FITS 4.0 I/O library. Aperture is built with TypeScript, React, and vinext. FITS parsing runs in a dedicated Web Worker backed by WebAssembly, so selected observations stay on the user's device.

Open the live demo

Features

• Drag-and-drop support for .fits, .fit, .fts, and gzip-compressed FITS
• Image HDU navigation and searchable header cards
• 1-D, 2-D, and N-D data cube plane rendering
• Linear, square-root, logarithmic, and asinh stretches
• Monochrome, Viridis, Magma, and night-amber color maps
• Interactive pan, zoom, FITS-origin coordinates, and pixel readout
• Per-plane statistics and structural FITS verification

Run locally

Node.js 22.13 or newer is required.

npm install
npm run dev

Open the URL printed by the development server. Build and validate with:

npm test

The production target is a Cloudflare Worker-compatible vinext bundle.

GitHub Pages

Pushes to main build a path-aware static export and deploy it with GitHub Actions. To reproduce that build locally:

GITHUB_PAGES=true GITHUB_REPOSITORY=anhydrous99/web-fits-viewer npm run build:pages

The GitHub Pages artifact is written to dist/client/. The standard npm run build command remains the Cloudflare Worker-compatible target.