Skip to content

ViewGraph 0.1.0 Alpha 1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@coper101 coper101 released this 29 Sep 16:23
· 1 commit to main since this release
v0.1.0-alpha.1
bd760ff
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

ViewGraph 0.1.0-alpha.1

Visualize the structure of your SwiftUI app.

ViewGraph overview ViewGraph graph canvas

ViewGraph analyzes SwiftUI projects and helps you understand how screens,
components, navigation, previews, and code changes relate to each other. It runs
locally on your Mac.

  • Version: 0.1.0-alpha.1
  • Requires: macOS 15.0 or later
  • Preview workflows: Xcode 16 or later
  • Architectures: Apple silicon and Intel (universal)
  • Distribution: signed and notarized DMG

What you can explore

Screens & Navigation

Screens and navigation graph

Open a SwiftUI project and explore its view graph on an interactive canvas.
Screens and their navigation connections are laid out so you can follow how one
screen leads to another.

Components

Component graph

See how views are composed from smaller components. ViewGraph groups the graph
into levels so you can trace which components make up a screen and where a
component is reused.

SwiftUI Previews

SwiftUI previews in ViewGraph

ViewGraph builds and captures previews using Xcode and the iOS Simulator, then
caches them per revision so previews stay attached to the graph as your project
changes.

Commit Impact

Commit impact graph

Compare the graph across Git commits and see which parts of the view graph a
revision affects without reading the whole diff.

Alpha status

This is an early public alpha.

Current focus:

  • SwiftUI projects
  • iOS / iPhone-first support
  • screen, component, and navigation analysis
  • preview rendering
  • commit-impact exploration

Expect unsupported project structures and preview edge cases. Some projects may
not analyze cleanly, and some previews may fail depending on the project's
toolchain and configuration.

Install

  1. Download ViewGraph-0.1.0-alpha.1.dmg from this release.
  2. Open the DMG.
  3. Drag ViewGraph into Applications.
  4. Launch ViewGraph.
  5. Open a SwiftUI project.

This is a pre-release build. It is signed with a Developer ID certificate,
notarized by Apple, and stapled for offline launch.

Verify the download

Run:

shasum -a 256 ViewGraph-0.1.0-alpha.1.dmg

Expected SHA-256:

73f758655a97137b80098837f97c15b3d3191eb97df77c6888743723ce72c278

The output should match the checksum above exactly.

Feedback

Please report bugs through GitHub Issues:

https://github.com/coper101/ViewGraph-Releases/issues/new

Useful information to include:

  • ViewGraph version
  • macOS version
  • Xcode version
  • reproduction steps
  • a screenshot or relevant diagnostics
  • a small sample project, if possible

Privacy and security

  • ViewGraph itself has no telemetry and no direct application-managed networking.
  • Xcode and Swift Package Manager may download dependencies during preview workflows.
  • Previewed project code may perform network requests or other side effects.
  • ViewGraph copies most non-hidden project content into its Application Support mirror.
  • Persisted snapshots can contain project paths, file names, diagnostics, preview bodies, and invocation expressions.

Xcode, Swift Package Manager, and code executed by previewed projects operate
outside ViewGraph's direct networking behavior and may access the network.
Review these points before opening sensitive projects.

Known limitations

  • Preview rendering requires a working Xcode installation and an available iOS Simulator.
    Without Xcode, analysis, canvas, bookmarks, and Git history still work, but
    preview rendering is unavailable.
  • Preview workflows currently target iPhone. iPad-specific preview behavior
    is not supported in this alpha.
  • Some project structures and preview configurations may not yet be supported.
  • This is an alpha; UI and stored data formats may change between builds.
  • Intel runtime behavior is currently unverified on physical Intel hardware.

Release

  • Tag: v0.1.0-alpha.1
Assets 4
Loading