Unofficial native iOS dashboard for AirVPN, built with SwiftUI and the iOS 26 Liquid Glass design.
⭐ If you find this project useful, a star on GitHub is greatly appreciated!
Disclaimer — This is an independent project with no affiliation to AirVPN. It uses the public AirVPN API with your personal API key.
- Network — full server list with load, users, health, ping latency, sort (load / name / ping), continent filter, search and favorites (scoped per account)
- Best Server — automatically picked from live ping and load, weighted so a congested server can't win purely on a low ping; instantly shows the previous session's result while the fresh ping sweep is running
- Server history & trends — load and connected-users charts per server over 1h/24h/7d/30d, a reliability breakdown (healthy vs warning/error) also surfaced as a badge on favorite servers and in Trends, a peak-hours chart highlighting the quietest 3-hour window from 7 days of history, and a Trends screen ranking servers by average load over a rolling window — all powered by a companion history service, not the official AirVPN API
- Server comparison — long-press any server to add it to a comparison (up to 3); tap the toolbar button to view them side by side, including bandwidth and an overlaid load-history chart across the compared servers
- Dashboard — account info (current IP, VPN status, expiration, credits, sessions, member since); swipe left on a session to disconnect, tap a session to jump to its server detail
- Server detail — WireGuard or OpenVPN profile generation, direct import into the system VPN app, share and QR code (WireGuard) in a
···menu; recent profiles per server with one-tap reimport, shown with the protocol's logo - Recent profiles page — dedicated list of all generated profiles with search, sort, filter by protocol, quick import, QR code and delete; profile history is stored securely in the Keychain
- Spotlight search — favorite servers and recent profiles are indexed and searchable from the system search; tapping a result opens the app directly on the right screen
- Biometric lock — Face ID / Touch ID protection, toggleable in Settings
- App icon — 8 variants: Auto, Classic, Light, Purple, Green, Red, Minimal, Minimal Dark
- Multiple accounts — add, switch and remove AirVPN accounts from Settings; the active account drives the whole app, including the widget
- Device management — add, rename, renew WireGuard keys and remove devices directly from Settings (10-device account limit enforced)
- DNS blocklists — browse AirVPN's available DNS blocklists with a direct link to manage them on airvpn.org
- Settings — account switching, device management, DNS blocklists, light/dark/system theme, app icon picker, changelog, credits (with trademark disclaimers for AirVPN, WireGuard and OpenVPN)
- Notifications — subscription expiration alerts 7 days and 1 day in advance (delivered by the OS even when the app is closed)
- Siri Shortcuts — VPN Status, My IP Address, Open Server, Best Server, Generate Profile, Recent Profiles, Show Profile QR Code
- Widgets — two home screen widgets: AirDash (current IP, VPN status, active sessions with flags and duration; configurable with a favorite server picker showing a load bar, users, latency and a favorite indicator, Small/Medium/Large) and AirDash Compte (Small only — VPN status, connected server when active, login and subscription expiration)
- Quick Actions — long-press the app icon to jump directly to Dashboard or Network
| Language | Swift 6 |
| UI | SwiftUI + iOS 26 Liquid Glass |
| Architecture | MVVM (@MainActor + ObservableObject) |
| Networking | actor AirVPNAPIClient (AirVPN) + actor AirVPNHistoryClient (history/trends), both with TTL caches |
| Charts | Swift Charts (server load, connected users) |
| Security | API key and profile history stored in Keychain |
| Localisation | String Catalog (FR / EN) |
| Build | XcodeGen (project.yml) |
| Dependencies | FlagKit |
A pre-built unsigned IPA is available on the Releases page. Install it with one of the following tools:
| Tool | Widget support |
|---|---|
| AltStore | ✅ Full support |
| Sideloadly | ✅ Full support |
| LiveContainer |
The widget requires a proper system installation to access the shared App Group. LiveContainer sandboxing prevents this.
- Xcode 26 or later
- iOS 26 minimum (simulator or device)
- XcodeGen installed
- An AirVPN API key (account → Client Area → API)
brew install xcodegenThe .xcodeproj is not versioned — generate it after cloning:
git clone https://github.com/zlimteck/AirDash.git
cd AirDash
xcodegen generate
open AirDash.xcodeprojXcode downloads FlagKit automatically on first launch. If not:
File → Packages → Resolve Package Versions
- Simulator — no configuration needed, just hit ⌘R
- Real device — Xcode → targets
AirDashandAirDashWidget→ Signing & Capabilities → select the same Apple team on both
The widget and the app share an App Group (
group.com.airdash.ios). Both targets must be signed with the same team for the group to work on a real device.
After adding any .swift file outside of Xcode, run xcodegen generate before building.
AirDash/
├── AirDash/
│ ├── App/ # Entry point, AppState, AppDelegate, SceneDelegate, MainTabView
│ ├── Intents/ # AppIntents (Siri Shortcuts), ServerEntity
│ ├── Models/ # AirVPNModels, AirVPNHistoryModels, Account, AppError
│ ├── Networking/ # AirVPNAPIClient (actor), AirVPNHistoryClient (actor), CacheService
│ ├── Services/ # KeychainService, VPNProfileImporter, SharedDataService, PingService, NotificationService, AppLockService, ProfileHistoryService, RelativeTimeFormatter, SpotlightService
│ ├── ViewModels/ # DashboardViewModel, NetworkStatusViewModel, …
│ ├── Views/
│ │ ├── Components/ # FlagBadge, LoadBar, ErrorBanner, LoadingOverlay, …
│ │ ├── Dashboard/ # DashboardView, SessionRowView, AllProfilesView
│ │ ├── NetworkStatus/ # NetworkStatusView, ServerRowView, ServerComparisonView, ComparisonHistoryView, TrendsView
│ │ ├── Onboarding/ # OnboardingView
│ │ ├── ServerDetail/ # ServerDetailView, ServerHistoryChartView, PeakHoursView, QRCodeView
│ │ └── Settings/ # SettingsView, ManageAccountsView, ManageDevicesView, DNSListsView, ChangelogView, CreditsView, AppIconPickerView
│ └── Resources/ # Localizable.xcstrings, Assets.xcassets
└── AirDashWidget/ # Widget Extension (WidgetKit)
└── AirDashWidget.swift # WidgetBundle with two widgets (AirDash, AirDash Compte), AppIntentProvider, server picker intent
The app and the widget communicate via UserDefaults(suiteName: "group.com.airdash.ios"). After each Dashboard load, SharedDataService writes the data and automatically reloads the widget.
The app's core features use the public AirVPN API with your personal API key:
| Endpoint | Usage |
|---|---|
POST /api/status/ |
Server list and network stats |
POST /api/userinfo/ |
Account info and active sessions |
POST /api/disconnect/ |
Disconnect a VPN session |
POST /api/devices/ |
Device management (list, add, renew, modify, delete) |
POST /api/dns_lists/ |
Available DNS blocklists |
GET /api/generator/ |
WireGuard / OpenVPN profile generation |
Server history, reliability, and the Trends ranking are powered by a separate, self-hosted service (a Cloudflare Worker backed by D1) that polls AirVPN's public server status on a schedule and stores it over time — something the AirVPN API itself doesn't offer. It's read-only, requires no authentication, and never receives your API key or any personal data: it only ever sees the same public server metrics (load, users, health) that are already visible to anyone on the Network tab.
- Disconnecting a session via the app does not kill the active VPN tunnel on the device (this would require the Personal VPN entitlement and
NETunnelProviderManager, which require a paid developer account) - Widget and alternate app icons are not supported when installed via LiveContainer (system-level features require a native installation)
- Enabling or disabling a DNS blocklist is not exposed by the AirVPN API; the app links out to airvpn.org to manage active lists
- iPhone and iPad
- iOS 26 or later
MIT