https://github.com/johnsundell/playground
Instantly create Swift playgrounds from the command line
https://github.com/johnsundell/playground
playground swift swift-playgrounds xcode
Last synced: 3 months ago
JSON representation
Instantly create Swift playgrounds from the command line
- Host: GitHub
- URL: https://github.com/johnsundell/playground
- Owner: JohnSundell
- License: mit
- Created: 2015-11-11T23:01:45.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-09-11T03:07:33.000Z (almost 5 years ago)
- Last Synced: 2025-03-30T02:06:37.904Z (4 months ago)
- Topics: playground, swift, swift-playgrounds, xcode
- Language: Swift
- Homepage:
- Size: 40 KB
- Stars: 449
- Watchers: 19
- Forks: 34
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Playground
[](#)
[](https://github.com/apple/swift-package-manager)
[](https://twitter.com/johnsundell)
Welcome to `playground`, a Swift script that enables you to super quickly generate Swift playgrounds from the command line - with or without dependencies - for any supported platform.
It essentially provides a command line interface to [Xgen](https://github.com/johnsundell/xgen).
**Features**
- [X] Generate playgrounds in seconds.
- [X] Automatically reuse any playground created today, for easy code note taking.
- [X] Add dependencies to a playground with a simple command - no more fiddling with workspaces.
- [X] Easily open a Gist or code from a GitHub URL in a playground.
- [X] Supports iOS, macOS & tvOS.
## Usage
**Simply run `playground` and a new playground will be created and opened**
```
$ playground
```
You can also supply various arguments to customize your playground:
**Add a playground at a specific path**
```
$ playground -t ~/MyPlayground
```
**Add some dependencies to your playground**
```
$ playground -d ~/unbox/unbox.xcodeproj,~/files/files.xcodeproj
```
**Open the contents of a Gist, a GitHub URL or any other URL in a playground**
```
$ playground -u https://gist.github.com/JohnSundell/b7f901e8edb89d1396ede4d8db3e8c21
```
**Quickly get started with view code prototyping**
```
$ playground -v
```
**Specify what platform you want the playground to run on**
```
$ playground -p tvOS
```
*For all available options, run `$ playground -h`*
## Installation
The easiest way to install `playground` is using the Swift Package Manager:
```
$ git clone https://github.com/JohnSundell/Playground.git
$ cd Playground
$ swift build -c release
$ install .build/release/Playground /usr/local/bin/playground
```
## Help, feedback or suggestions?
- [Open a PR](https://github.com/JohnSundell/Playground/pull/new/master) if you want to make some change to `playground`.
- Contact [@johnsundell on Twitter](https://twitter.com/johnsundell) for discussions, news & announcements about `playground` & other projects.