The contract document is vendored as schema/devices.openapi.json, with the mainapp revision and its SHA-256 in schema/source.json, and swiftsupport 1.4.0 generates from it, so no mainapp checkout is needed beside this repository. The generated Swift is unchanged below its header.
@skyglide.com/swiftapp
Skyglide for iPhone, iPad and Mac. At a Skyglide location a device joins its member's private network through the skyglide.com Wi-Fi; everywhere else this app connects it to the same network through the Skyglide cloud, over WireGuard.
Issue Reporting and Security
For reporting bugs, issues, or security vulnerabilities, please visit community.foss.global/. This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a code.foss.global/ account to submit Pull Requests directly.
What it does
- Setup: the first screen says what Skyglide processes. Name the device, confirm it on the Skyglide member portal, which opens in a browser sheet on top of the app and where you sign in with idp.global, allow the VPN configuration, done. The app never sees your password. The device's WireGuard key is created on the device and stays in its keychain; your account only learns its public half.
- Status: connected through the Skyglide cloud; at a Skyglide location, where the connection stays idle once the Skyglide cloud confirms the Wi-Fi really is your network (a network with the same name elsewhere does not count); disconnected; waiting for a hotel's or train's Wi-Fi sign-in page; membership paused.
- Internet through Skyglide: off by default, so only traffic to your own devices uses Skyglide. Turned on, all traffic goes through the Skyglide cloud; the app's own questions to the Skyglide service stay on the network you are on, so it still notices a Skyglide location. It needs an IPv6 address for the device, which the service does not hand out yet.
- Devices: your devices away from a location and at each location, with their addresses and private names to copy, and when an offline device was last seen.
- Settings: membership, Connect automatically, the internet exit (your network's, or one of its exits for this device alone), the addresses chosen in the member portal, this device's name (rename it here; its private name follows), address and key, removing the device from your network, and the privacy policy, the account deletion request, the third-party notices and help.
On the iPhone the app has a tab bar; on the iPad a sidebar. On the Mac it lives in the menu bar, with a window for status, devices and settings; it can run beside the Skyglide app from skyglide.com, but only one of them connects at a time.
State
Skyglide is being built. The app signs in to the Skyglide controller, enrolls the device and follows its configuration, devices and changes; its contracts are generated from the controller's own (skyglide.com/mainapp) with @api.global/swiftsupport. Its tunnel runs WireGuard through WireGuardKit, the WireGuard project's library for Apple systems. No real device has run the tunnel yet: the simulator runs no VPN, and a signed build needs the team's account. Release builds talk to https://app.skyglide.com, the planned address of the Skyglide service. The app is in English.
Version 1.0.0 is prepared for the App Store: store/appstore/ holds the listing in English and German, the screenshots, the privacy and age rating answers, the review notes, the export compliance answer and the checklist of what is left before a submission. Nothing has been uploaded or submitted.
Development
Needs a Mac with Xcode 26 or later and a Go toolchain (brew install go): the tunnel extension links wireguard-go, which every build compiles from Vendor/wireguard-apple.
pnpm run contracts:check # with skyglide.com/mainapp checked out beside this repository
cd SkyglideKit && swift test
xcodebuild build -project Skyglide.xcodeproj -scheme Skyglide -destination 'generic/platform=iOS Simulator'
xcodebuild test -project Skyglide.xcodeproj -scheme Skyglide -destination 'platform=iOS Simulator,name=iPhone 18 Pro'
xcodebuild test -project Skyglide.xcodeproj -scheme Skyglide -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NO
scripts/archive.sh ios # or macos: an archive for the App Store in .nogit/build
scripts/export.sh ios # signs it; needs Xcode signed in to the team's account. Nothing is uploaded.
Debug builds talk to a development controller on this device with -SkyglideController http://localhost:<port>, and show every screen with sample data: xcrun simctl launch <device> com.skyglide.app -SkyglideDemo connected (also welcome, name, waiting, permission, done, location, off, captive, restricted, other; add -SkyglideTab devices or settings). On the Mac, Skyglide.app/Contents/MacOS/Skyglide -SkyglideSnapshots <directory> renders every window screen into PNGs.
Third-party software
The tunnel extension contains WireGuardKit and wireguard-go (MIT, WireGuard LLC), the Go runtime and golang.org/x/crypto, net and sys (BSD-3-Clause with a patent grant, The Go Authors); the app contains api.global's swiftsupport (MIT, Lossless GmbH). The app shows their notices under "Third-party notices"; the texts are in notices/. WireGuard is a registered trademark of Jason A. Donenfeld.
License and Legal Information
This repository is licensed under the MIT license, see license.md.