artifact.ci
View your GitHub artifacts in the browser.
How
artifact.ci is a GitHub App that provides browsable links for artifacts uploaded during GitHub Actions workflow runs.
View test reports, code coverage, PDFs, images, and more, directly in your browser. No more downloading and unzipping.
It’s a small tool which solves a specific, hopefully temporary, shortcoming of GitHub Actions. To use it, all you need to do is install the app. Then use actions/upload-artifact
as normal in your workflow. It will add a link to view any artifacts uploaded via GitHub checks.
Here’s an end-to-end example of a repo installing the app, then using vitest’s HTML report to view test results in-browser:
Here’s an example of what the GitHub App produces, on the expect-type repo: it’s a simple link to the viewable artifact as a GitHub check: https://github.com/mmkal/expect-type/runs/31567129309
Why
CI jobs often generate useful HTML reports (test results, coverage, etc.). GitHub Actions doesn’t provide a way to view these directly. The existing option is to use actions/upload-artifact
, then download it as a zip file, unzip it on your local machine, and then poke around at the files or run a local server. This app fills that gap, letting you view artifacts in your browser without downloading and unzipping.
This should really be a feature built into GitHub, and likely one day will be, but for now it isn’t. (Note: it is built into some other CI providers like CircleCI).
Usage
Guides for common tools:
Testing frameworks
Other languages
More
…you get the idea. If you can render it statically in a web browser, you can upload it to artifact.ci.
Security
The app requires minimal permissions, operates read-only, and uses GitHub’s APIs and authentication. It maintains your repository’s existing access controls. See the privacy policy for more details.
Who
This is my side project, something I built initially for my own use in support of another project I’m working on.
Pricing
The actual service doesn’t have a paywall for now, and usage is free to start out with. Access may be limited to my GitHub sponsors due to storage costs. I’m giving some users and organizations free access - this is based on how much I use them myself, but if you would like to use this without sponsorship, contact me.
Usage and Availability
There’s no API surface right now. Just install the app and it should “just work” - it’ll find your artifacts automatically. There are a small number of options that can be customised, see advanced usage docs. Usage limits may be introduced in future, or a proper payments setup.
Note that the GitHub team have mentioned a built-in solution is on their radar, so hopefully this will only be necessary for a short while.