IVPN for iOS is a native app built using Swift language. Some of the features include: multiple protocols (IKEv2, OpenVPN, WireGuard), Kill-switch, Multi-Hop, Trusted Networks, AntiTracker, Custom DNS, Dark mode and more.
IVPN iOS app is distributed on the App Store.

• About this Repo
• Installation
• Testing
• Deployment
• Versioning
• Contributing
• Security Policy
• License
• Authors
• Acknowledgements

This is the official Git repo of the IVPN for iOS project.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

• iOS 12.0+
• Xcode 12.0+
• Swift 5.0+
• CocoaPods 1.10.0+
• fastlane 2.178.0+
• Go 1.16+

Project dev dependencies:

• CocoaPods
• fastlane
• SwiftLint
• Go

Install CocoaPods, fastlane, SwiftLint and Go:

$ brew install cocoapods fastlane swiftlint go

Dependencies are installed with CocoaPods.
WireGuard static library is compiled at Xcode build phase from implementation of WireGuard in Go.

Project dependencies:

• wireguard-go
• TunnelKit
• SnapKit
• KeychainAccess
• SwiftyStoreKit
• JGProgressHUD
• ActiveLabel
• ReachabilitySwift
• FloatingPanel

To pull and build dependencies run:

$ pod install  
$ open IVPNClient.xcworkspace  

There are different build configurations: Staging and Release.

Rename and populate .xcconfig files:

$ cp IVPNClient/Config/staging.template.xcconfig IVPNClient/Config/staging.xcconfig  
$ cp IVPNClient/Config/release.template.xcconfig IVPNClient/Config/release.xcconfig  
$ cp wireguard-tunnel-provider/Config/wg-staging.template.xcconfig wireguard-tunnel-provider/Config/wg-staging.xcconfig   
$ cp wireguard-tunnel-provider/Config/wg-release.template.xcconfig wireguard-tunnel-provider/Config/wg-release.xcconfig  
$ cp today-extension/Config/today-extension-staging.template.xcconfig today-extension/Config/today-extension-staging.xcconfig  
$ cp today-extension/Config/today-extension-release.template.xcconfig today-extension/Config/today-extension-release.xcconfig   

Rename and populate OpenVPNConf.swift file:

$ cp IVPNClient/Config/OpenVPNConf.template.swift IVPNClient/Config/OpenVPNConf.swift

Rename and populate Appfile files:

$ cp fastlane/Appfile.template fastlane/Appfile

Run code linter using fastlane:

$ fastlane lint

Run tests using fastlane:

$ fastlane test

Alternatively, run tests using xcodebuild:

$ xcodebuild test -workspace IVPNClient.xcworkspace -scheme IVPNClient -destination 'platform=iOS Simulator,name=iPhone 11'

To build and deploy beta build to TestFlight:

$ fastlane beta

To build and deploy staging build to TestFlight:

$ fastlane staging

To build and deploy App Store release build to TestFlight:

$ fastlane release

Project is using Semantic Versioning (SemVer) for creating release versions.

SemVer is a 3-component system in the format of x.y.z where:

x stands for a major version
y stands for a minor version
z stands for a patch

So we have: Major.Minor.Patch

If you are interested in contributing to IVPN for iOS project, please read our Contributing Guidelines.

If you want to report a security problem, please read our Security Policy.

This project is licensed under the GPLv3 - see the License file for details.

See the Authors file for the list of contributors who participated in this project.

See the Acknowledgements file for the list of third party libraries used in this project.