Artyfact

HTML decks that travel as one file.

Claude can build you a slide deck in HTML, with live charts, animation and speaker notes. Artyfact packs it into one .artyfact file that opens in the Artyfact app on your Mac, or in any browser, with no internet. Unpack it later and the editable source comes back.

Version 0.1.0 Apple Silicon macOS 11 or later 3.4 MB installer
The download and install steps are on one page.

q3-hiring-review.artyfact 344 KB

The whole deck, one file, running in this page. Click it, then use ← →, or swipe. Sample data. Open it full size

An HTML deck is really a folder.

A deck Claude writes in HTML looks great on the machine that made it. To anyone else it is a folder of files and a few things fetched from the internet. This is the sample deck above, before packing.

Before: the source folder

  • q3-hiring-review/8 files
  • index.html6.2 KB
  • styles.css5.7 KB
  • app.js3.5 KB
  • js/kpis.js0.7 KB
  • js/format.js0.2 KB
  • data/metrics.json0.7 KB
  • img/mark.svg, img/grid.svg0.6 KB
  • fonts.googleapis.comSchibsted Grotesk
  • cdn.jsdelivr.netChart.js 4.4.1
  • Eight files to send. It goes out as a zip, and someone has to unzip it and find index.html.
  • It needs the internet. Offline, the font and Chart.js never arrive, so the charts never draw.
  • Opened from disk, Chrome blocks it. The JavaScript module and the data file are refused, so the numbers never load.

After: one file

q3-hiring-review.artyfact 344 KB

Everything is inside, as plain text you can inspect:

  • the eight source files, inlined
  • Schibsted Grotesk and Chart.js, downloaded at pack time
  • the JavaScript module, bundled
  • a player of about 25 KB for slides, builds, notes and PDF

Nothing is fetched when it opens. Double-click it on a plane and it works.

Make it, pack it, open it, unpack it.

The file is never a dead end. A deck someone sends you can go back to source, get edited, and be packed again.

Packing and unpacking use the artyfact command-line tool, which isn't published yet. Today you can open decks in the app or any browser, and the Claude Code skill can write them.

  1. Make

    Claude, or you, writes the deck as an ordinary folder of HTML, CSS and JavaScript. Each slide is a section; click-by-click reveals and speaker notes are plain attributes.

    <section class="slide">
      <h2>Q3 at a glance</h2>
      <p data-step>248 hires</p>
    </section>
  2. Pack

    Puts every file inside, downloads the web libraries and Google Fonts the deck uses, and adds the player. artyfact check then opens the result with the network blocked and reports anything broken.

    artyfact pack q3-review
    # q3-review.artyfact
  3. Open

    Double-click the .artyfact and it opens in the Artyfact app. Rename it to .html and it opens in any browser: the bytes are identical.

    artyfact pack q3-review \
      -o q3-review.html
  4. Unpack

    Restores the original folder file for file, byte for byte. The round trip is tested, so a repack gives the same file.

    artyfact unpack q3-review.html \
      -o q3-review-src

Then edit and pack again. The player inside is replaced on every repack, so old decks pick up fixes.

Double-click a deck. It opens in its own window.

The Artyfact app is the default app for .artyfact files on your Mac. Each deck runs in its own sandboxed window, so a deck somebody sent you can't reach your files or the network unless you allow it.

The Artyfact app

For Macs with Apple Silicon. A 3.4 MB download.

Sandboxed
No access to your files or to the app. Links in a deck open in your normal browser.
Offline by default
No network unless you turn on View › Allow Network for This Deck.
Presenter view
Notes and a timer in a second window while the deck plays full screen.
Export as HTML
File › Export as HTML makes a copy for people who don't have the app.

No app? Any browser.

Send the .html copy and it opens with a double-click. The same player comes with every deck:

→Space
Next build or slide
←
Previous
O
Overview of all slides
S
Presenter view with notes and timer
F
Full screen

Swipe on touch screens. Press ? in any deck for every shortcut. Save as PDF prints one slide per page.

Let Claude make the decks.

The artyfact-deck skill teaches Claude Code the deck format and a routine to follow: write the slides, pack them, open the file with the network blocked, look at every slide, and fix what's off before handing it over.

Put it where Claude Code looks

$ mkdir -p ~/.claude/skills
$ unzip -o ~/Downloads/artyfact-deck-skill.zip -d ~/.claude/skills

Then ask for a deck

One catch for now: the skill packs decks with the artyfact command-line tool, which isn't available to download yet. Without it, Claude can still write the deck folder, but can't pack it into one file.

  • Make a six-slide deck on our Q3 hiring numbers and pack it as one file.
  • Turn this report into a presentation I can email.
  • Unpack this .artyfact so I can change slide 4.

Get Artyfact for Mac.

Version 0.1.0, for Macs with Apple Silicon (M1 or later) on macOS 11 or later. There is no Windows or Intel build yet; people on those machines can still open any deck as .html in their browser.

Download Artyfact.pkg 3.4 MB

Prefer a disk image? Artyfact.dmg (3.5 MB)

Read the install steps before you open it.