Skip to content

Refresh marketing site for Swiftpkgr 0.3.0 #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jordancalhoun merged 2 commits into from
Jul 17, 2026
Merged

Refresh marketing site for Swiftpkgr 0.3.0 #6

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d8299de
feat: refresh marketing site for Swiftpkgr
jordancalhoun Jul 17, 2026
fb205ce
docs: remove unreleased Swiftpkgr build instructions
jordancalhoun Jul 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 24 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,11 @@
[![License](https://img.shields.io/github/license/codecarton/swiftpkg)](LICENSE)
[![macOS 13+](https://img.shields.io/badge/macOS-13%2B-000000?logo=apple&logoColor=white)](https://support.apple.com/macos)

`swiftpkg` is a macOS command-line tool for building Apple installer packages
from version-control-friendly project directories. It is a Swift implementation
of [`munki-pkg`](https://github.com/munki/munki-pkg).
`swiftpkg` is a native toolkit for building Apple installer packages from
version-control-friendly project directories. Use the command-line tool for
automation today; Swiftpkgr, its macOS desktop companion, brings a visual
workflow in the 0.3.0 release. Both are powered by the same Swift
implementation of [`munki-pkg`](https://github.com/munki/munki-pkg).

## Install for Mac administrators

Expand Down Expand Up @@ -70,6 +72,23 @@ Useful options:
--version Show the tool version
```

## Swiftpkgr desktop app — coming in 0.3.0

Coming in the swiftpkg 0.3.0 release, Swiftpkgr is the native macOS 15+
desktop companion to the macOS 13+ `swiftpkg` command-line tool. It opens the
same project directories and uses the same configuration, import, build, and
BOM implementation, so projects can move between visual and automated
workflows without conversion.

Swiftpkgr will let you create, open, or convert package projects; import
existing installer packages; edit package, distribution, signing, and
notarization values; and build packages while viewing operation progress. It
will import and export CLI-compatible plist, JSON, or YAML settings without
losing `${version}` placeholders.

Swiftpkgr will be included in the same installer package as the CLI beginning
with 0.3.0.

## Project layout

```text
Expand Down Expand Up @@ -99,10 +118,10 @@ swift test
```

The Swift Package Manager dependency [Yams](https://github.com/jpsim/Yams)
provides YAML support. The Xcode project also builds with:
provides YAML support. The CLI target also builds with:

```sh
xcodebuild -project swiftpkg.xcodeproj -scheme swiftpkg -configuration Release build
xcodebuild -project swiftpkg.xcodeproj -scheme swiftpkg -configuration Release CODE_SIGNING_ALLOWED=NO build
```

## Maintainer releases
Expand Down
Binary file modified site/assets/og.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
67 changes: 55 additions & 12 deletions site/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,20 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="swiftpkg builds dependable macOS installer packages from version-control-friendly project directories.">
<meta name="theme-color" content="#090b10">
<meta name="description" content="Build dependable macOS installer packages from the command line, with the native Swiftpkgr desktop app coming in 0.3.0.">
<meta name="theme-color" content="#f2f0e8">
<meta property="og:type" content="website">
<meta property="og:title" content="swiftpkg — Build better macOS installer packages">
<meta property="og:description" content="A focused command-line tool for building Apple installer packages from version-control-friendly projects.">
<meta property="og:description" content="The swiftpkg CLI today, plus the native Swiftpkgr desktop app coming in 0.3.0.">
<meta property="og:url" content="https://codecarton.github.io/swiftpkg/">
<meta property="og:image" content="https://codecarton.github.io/swiftpkg/assets/og.png">
<meta property="og:image:width" content="1731">
<meta property="og:image:height" content="909">
<meta property="og:image:alt" content="swiftpkg shown beside a precise charcoal package-build control panel with an orange status control.">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="swiftpkg — Build better macOS installer packages">
<meta name="twitter:description" content="The swiftpkg CLI today, plus the native Swiftpkgr desktop app coming in 0.3.0.">
<meta name="twitter:image" content="https://codecarton.github.io/swiftpkg/assets/og.png">
<title>swiftpkg — macOS package building, without the noise</title>
<link rel="stylesheet" href="styles.css">
</head>
Expand All @@ -23,20 +29,21 @@
</a>
<nav aria-label="Primary navigation">
<a href="#workflow">How it works</a>
<a href="#desktop-app">Desktop app</a>
<a href="#built-for-admins">Why swiftpkg</a>
<a href="https://github.com/codecarton/swiftpkg/releases/latest">Latest release <span aria-hidden="true">↗</span></a>
<a class="nav-github" href="https://github.com/codecarton/swiftpkg">View project <span aria-hidden="true">↗</span></a>
<a class="nav-github" href="https://github.com/codecarton/swiftpkg">View on GitHub <span aria-hidden="true">↗</span></a>
</nav>
</header>

<main id="main">
<section class="hero">
<div class="hero-copy">
<p class="eyebrow"><span></span> The munki-pkg workflow, rebuilt in Swift</p>
<h1>Build better<br><em>macOS</em> installer packages.</h1>
<p class="lede">A native command-line tool for turning clean, version-controlled project directories into dependable Apple installer packages.</p>
<p class="eyebrow"><span></span> macOS packaging, made practical</p>
<h1>The munki-pkg<br>workflow, rebuilt<br><em>in Swift</em></h1>
<p class="lede">Build from the command line today. In 0.3.0, the native Swiftpkgr desktop app brings the same dependable package workflow to a focused visual workspace.</p>
<div class="hero-actions">
<a class="button button-primary" href="https://github.com/codecarton/swiftpkg/releases/latest">Download latest release <span aria-hidden="true">→</span></a>
<a class="button button-primary" href="https://github.com/codecarton/swiftpkg/releases/latest">Get swiftpkg <span aria-hidden="true">→</span></a>
<a class="button button-quiet" href="#workflow">See the workflow <span aria-hidden="true">↓</span></a>
</div>
<p class="availability"><span class="status-dot" aria-hidden="true"></span> macOS 13+ · Universal 2 · GPL-3.0-or-later</p>
Expand All @@ -48,7 +55,7 @@ <h1>Build better<br><em>macOS</em> installer packages.</h1>
<div class="terminal-body">
<p><b>~</b> <span class="muted">$</span> swiftpkg <span class="cyan">./MyApp</span></p>
<p class="terminal-output">Building MyApp-2.3.pkg</p>
<div class="line long"></div><div class="line medium"></div><div class="line short violet"></div>
<div class="line long"></div><div class="line medium"></div><div class="line short accent"></div>
<p class="terminal-success"><span>✓</span> Package created successfully</p>
</div>
</div>
Expand Down Expand Up @@ -89,6 +96,43 @@ <h3>Build with confidence</h3>
</ol>
</section>

<section class="desktop section" id="desktop-app">
<div class="desktop-copy">
<p class="eyebrow"><span></span> Coming in 0.3.0 · Meet Swiftpkgr</p>
<h2>A desktop workspace<br>for package projects.</h2>
<p>Arriving in swiftpkg 0.3.0, Swiftpkgr brings the same package engine and portable project format into a native macOS app. Create a project, import an existing installer, edit its settings, and follow the build from one focused workspace.</p>
<ul>
<li><b>Edit with confidence</b><span>Work with package, distribution, signing, and notarization settings in a structured editor.</span></li>
<li><b>Move between app and CLI</b><span>Open the same plist, JSON, or YAML projects without converting them to a proprietary format.</span></li>
<li><b>See the work happen</b><span>Build packages and follow operation progress without leaving the app.</span></li>
</ul>
<p class="desktop-availability">Swiftpkgr requires macOS 15 or later and will ship in the swiftpkg 0.3.0 installer.</p>
</div>
<div class="app-window glow-panel" aria-label="Swiftpkgr desktop app preview">
<div class="app-titlebar">
<span></span><span></span><span></span>
<b>Swiftpkgr</b>
</div>
<div class="app-content">
<aside>
<small>PROJECT</small>
<b>MyApp</b>
<a class="active">Package</a>
<a>Distribution</a>
<a>Signing</a>
<a>Notarization</a>
</aside>
<div class="app-editor">
<small>PACKAGE SETTINGS</small>
<label>Name <span>MyApp-${version}</span></label>
<label>Identifier <span>com.example.myapp</span></label>
<label>Version <span>2.3</span></label>
<div class="build-row"><i></i><p><b>Ready to build</b><small>Project settings are valid</small></p><button>Build Package</button></div>
Comment on lines +111 to +130

@coderabbitai coderabbitai Bot Jul 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Remove the nonfunctional button from the accessibility tree.

Line 130 creates a keyboard-focusable “Build Package” button with no action inside a visual mock. Expose the preview as one labeled image and render the fake button as a styled span.

Proposed fix 
-      <div class="app-window glow-panel" aria-label="Swiftpkgr desktop app preview">
+      <div class="app-window glow-panel" role="img" aria-label="Swiftpkgr desktop app preview">
...
-            <div class="build-row"><i></i><p><b>Ready to build</b><small>Project settings are valid</small></p><button>Build Package</button></div>
+            <div class="build-row"><i></i><p><b>Ready to build</b><small>Project settings are valid</small></p><span class="preview-button">Build Package</span></div>

Update .build-row button to .build-row .preview-button in the stylesheet.

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@site/index.html` around lines 111 - 130, Update the app preview markup around
the “Build Package” control so the visual mock is exposed as one labeled image
and the nonfunctional control is no longer keyboard-focusable; replace the fake
button with a styled span using the preview-button class, and update the
corresponding .build-row button stylesheet selector to .build-row
.preview-button.

</div>
</div>
</div>
</section>

<section class="feature section" id="built-for-admins">
<div class="feature-visual glow-panel">
<div class="visual-label">package project</div>
Expand All @@ -99,7 +143,7 @@ <h3>Build with confidence</h3>
</div>
<div class="feature-copy">
<p class="eyebrow"><span></span> Made for real operations</p>
<h2>Everything you need.<br>Nothing you have to fight.</h2>
<h2>Projects you can review.<br>Packages ready to ship.</h2>
<p>swiftpkg follows the project model Mac admins already know while making package contents readable, reviewable, and easy to automate.</p>
<ul>
<li><b>Version-control friendly</b><span>Review every payload, script, and build setting in a normal project tree.</span></li>
Expand All @@ -121,11 +165,10 @@ <h2>Native to macOS.<br>Ready for your fleet.</h2>
</section>

<section class="closing">
<div class="closing-orb" aria-hidden="true"></div>
<p class="eyebrow"><span></span> Follow the project</p>
<h2>Your next package<br>deserves a better build.</h2>
<p>The latest swiftpkg release is available on GitHub. Download it, verify its checksum, and put a cleaner package workflow to work.</p>
<a class="button button-primary" href="https://github.com/codecarton/swiftpkg/releases/latest">Download latest release <span aria-hidden="true">↗</span></a>
<a class="button button-primary" href="https://github.com/codecarton/swiftpkg/releases/latest">Get swiftpkg <span aria-hidden="true">↗</span></a>
</section>
</main>

Expand Down
Loading