PyxisSwift package and web viewer · Free

See how your
app connects.

Pyxis turns the UI tests you already run into a map of screens, states and transitions. Follow a journey, compare variants, and share the whole picture in one file. Local-first and free.

—
Loading example…
Live example · Expand a domain or choose a journey. Drag to pan, pinch to zoom.Open in Pyxis ↗

Not a screenshotThe real Pyxis viewer with its bundled Notes example. Expand a domain or choose a journey, drag to pan, and pinch or ⌘ scroll to zoom. Open it full size ↗

A screenshot shows a state.
A map shows the journey.

NotesUITestsCreateNoteTests.swift
try await recorder.capture(home)
try await recorder.transition(
  from: home,
  to: editor,
  action: "Create note",
  perform: { app.buttons["create"].tap() }
)

Record from the tests you have

Add a PyxisRecorder to a synchronous or async XCTest. Capture the checkpoints that matter and record the actions between them. A failed transition stays in the recording.

Names that stay put

Stable state IDs survive renamed test methods, and give people and coding agents a shared way to say “the clipped title in notes.editor.empty”.

Every variant, side by side

Profiles record the same journey in dark mode, with larger text, or with your own launch values. Show all variants lays them out as one contact sheet.

Diff two states

Click one state, Shift-click another and run Diff. Or arm a diff source and compare whole pages, configurations or new recordings against it.

One file to share

Captures, state details and results travel in one .pyx archive. Open it in any browser without running the app again.

Everything is a ⌘K away

The command palette reaches every viewer action, and shortcuts are yours to record, change or reset.

Two parts. One recording.
Record in Swift, explore on the web.

The package and viewer work independently, connected by a portable recording format. The Swift package is MIT licensed; the viewer is free, with an open-source release planned.

pyxis-swift

Your tests already know the way

Add recording to existing or dedicated UI tests. Your app keeps its navigation, fixtures, and state IDs. Pyxis captures the checkpoints and exports the result

  • Add recording to synchronous or async XCTest journeys
  • Record and optimize a variant matrix or selected configurations from YAML
  • Update a persistent recording store and export a complete .pyx
  • Apply optional launch-time variant overrides
Swift package
pyxis-frontend

Give the recording room to unfold

Drop a recording onto the canvas and explore it by screen or state. Inspect captures, follow journeys, and compare variants without running the app again

  • Drop a .pyx file directly into the viewer
  • Inspect captures at their stored resolution and compare variants
  • Load images on demand
  • Explore recordings in the free browser viewer

From a test run
to the whole journey.

  1. 01

    Record a journey

    Choose meaningful checkpoints in your UI tests. Pyxis records their captures, variants, and transitions

  2. 02

    Build one artifact

    Record selected configurations and optimize images in one command. Export a complete .pyx, including earlier recordings retained in your store

  3. 03

    Explore the map

    Open the viewer and drop in a .pyx file. Follow a journey, inspect a state, or compare two captures

Your first .pyx in three commands.
Start with a sample recording.

Run from the package checkout

Generate a sample recording with synthetic screenshots, validate it, and pack it into a .pyx to drop into the viewer. Use a new archive name when you repeat it. Swift 6.2+ · macOS 14+

01 · Generate a recording
swift run pyxis demo --output .generated/demo
02 · Validate the bundle
swift run pyxis validate .generated/demo
03 · Package it for sharing
swift run pyxis pack .generated/demo --output .generated/demo.pyx

Get pyxis-swift

Keep it local.
Share it when it helps.

Local imports stay in the browser

The viewer reads imported files on your device. No upload endpoint, account requirement, or telemetry.

A recording you can keep

Export a complete .pyx, or save a copy for offline use in this browser. Keep your store locally, in Git or LFS, or on a mounted drive.

Share it with your team

Send a .pyx file for teammates to open in the viewer. Your app code and authored tests remain the source of truth.

And the small things you would miss.

  • Journeys across domains
  • Screens with several states
  • Dark mode profiles
  • Large text profiles
  • pyxis merge
  • pyxis optimize
  • System UI with .screen captures
  • Synchronous and async XCTest
  • Portable .pyx archives
  • Library of saved recordings
  • Custom shortcuts
  • Offline copies in the browser
  • State IDs agents can reference
  • MIT-licensed Swift package

FAQ

Is Pyxis free?

Yes. The Swift package is open source under the MIT license, and the browser viewer is free to use.

Where do my recordings go?

Nowhere you did not send them. The viewer reads imported files on your device, with no upload endpoint, account or telemetry. Saved copies stay in your browser's storage.

What can it record?

iOS apps, from XCTest UI tests on iOS 17 or later. The command-line tools need macOS 14 and Swift 6.2 or later.

Do I need to rewrite my UI tests?

No. Create a PyxisRecorder in an existing test and keep its assertions and base class, or subclass PyxisTestCase for tests dedicated to recording.

Is the viewer open source?

Not yet. An open-source release of the browser viewer is planned.

See where your next screen leads.
Open the viewer and drop in a .pyx.