An Xcodeproj-less tool for creating cross-platform Swift apps.

Supporting Swift Bundler ❤️

If you find Swift Bundler useful, please consider supporting me by becoming a sponsor. I spend most of my spare time working on open-source projects, and each sponsorship helps me focus more time on making high quality tools for the community.

Documentation 📚

The documentation is hosted on the Swift Bundler website.

Join the moreSwift Discord server if you have any questions.

Installation 📦

Install the latest version of Swift Bundler with mint:

mint install stackotter/swift-bundler@main

See Runtime dependencies for a list of runtime dependencies and associated installation instructions.

If you have previously installed Swift Bundler via the installation script you must delete the /opt/swift-bundler directory (requires sudo).

For more installation methods, see the documentation.

Getting started 🚦

After installing Swift Bundler, package templates make it quick to get started. The following sections walk you through creating and running a simple 'Hello, World!' SwiftUI app.

Creating a SwiftUI app

# Create a new app from the SwiftUI template.
swift bundler create HelloWorld --template SwiftUI
cd HelloWorld

Running the app

# Build and run the app.
swift bundler run

Using Xcode as your IDE

# Creates the files necessary to get xcode to run the package as an app.
# Only needs to be run once unless you delete the `.swiftpm` directory.
swift bundler generate-xcode-support

# Open the package in Xcode
open Package.swift

Learning more

To learn more about Swift Bundler refer to the documentation.

Contributing 🛠

Contributions of all kinds are very welcome! Just make sure to check out the contributing guidelines before getting started. Read through the open issues for contribution ideas.

Contributors generally discuss moreSwift development in the moreSwift Discord server; it's a great place to discuss contribution ideas or to get assistance with your contributions.

Bug response policy 🐞

Critical bugs will be addressed within 48 hours or less. Critical bugs are classified as any bugs that risk loss of user/developer data or represent critical security vulnerabilities (around 8 or above on the CVSS scale as a rule of thumb, although Swift Bundler maintainers retain discretion).

Non-critical bugs will be addressed in order of priority with no strict turnaround commitments. As a general rule of thumb, we'll address security vulnerabilities, then bugs reported by sponsors, then any other bugs as time permits.

Apps made with Swift Bundler 👨‍💻

If you have made an app with Swift Bundler, I'd love to hear about it! Just open an issue or submit a PR to add it to the list.

• Delta Client: A 'Minecraft: Java Edition' compatible Minecraft client written from scratch in Swift (macOS only)
• ModularMTL: A modular multiplication visualisation made with Swift Bundler, SwiftUI and Metal (macOS only)
• Friend: A technical demo that showcases how system-based assistants can be integrated with LLMs to provide greater flexibility and functionality (macOS only)
• AutoDock: A utility for automatically hiding and showing the macOS Dock based on connected display size. (macOS only)
• Arcmark: A bookmark manager that attaches to any browser window as a sidebar. (macOS only)