Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stackotter/swift-bundler

An Xcodeproj-less tool for creating cross-platform Swift apps.
https://github.com/stackotter/swift-bundler

hacktoberfest macos swift swiftpm xcode

Last synced: 5 days ago
JSON representation

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

Awesome Lists containing this project

README

        







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](https://github.com/sponsors/stackotter). 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](https://swiftbundler.dev/documentation/swiftbundler).

## Installation 📦

Install the latest version of Swift Bundler with [mint](https://github.com/yonaskolb/Mint):

```sh
mint install stackotter/swift-bundler
```

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](https://swiftbundler.dev/documentation/swiftbundler/installation).

## 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

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

### Running the app

```sh
# Build and run the app.
swift bundler run
```

### Using Xcode as your IDE

```sh
# 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](https://swiftbundler.dev/documentation/swiftbundler).

## Contributing 🛠

Contributions of all kinds are very welcome! Just make sure to check out [the contributing guidelines](CONTRIBUTING.md) before getting started. Read through [the open issues](https://github.com/stackotter/swift-bundler/issues) for contribution ideas.

## 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](https://github.com/stackotter/delta-client): A 'Minecraft: Java Edition' compatible Minecraft client written from scratch in Swift
- [ModularMTL](https://github.com/JezewskiG/ModularMTL): A modular multiplication visualisation made with Swift Bundler, SwiftUI and Metal