A professional iOS VPN application built with SwiftUI, designed to integrate seamlessly with V2Board panel APIs. This application provides a modern, intuitive interface for VPN management with comprehensive configuration options.

🚀 Features

Modern SwiftUI Interface: Responsive design that adapts to different screen sizes
Dark/Light Mode Support: Automatic theme synchronization with system preferences
V2Board API Integration: Complete integration with V2Board panel APIs
Network Management: Advanced networking capabilities using URLSession
Background Updates: Automatic profile updates with background task scheduling
Multi-platform Support: iOS 15.0+ with macOS compatibility

📋 Requirements

Before getting started, ensure your development environment meets the following requirements:

Xcode: 14.0 or later
iOS Deployment Target: 15.0 or later
Swift: 5.7+
Network Access: VPN required for Swift Package Manager dependencies

🏗️ Project Structure

iOS-SwiftUI-Code/
├── ApplicationLibrary/          # Core application library
│   ├── Service/                 # API services and managers
│   │   ├── StoreManager.swift   # Configuration storage manager
│   │   └── ProfileUpdateTask.swift # Background update tasks
│   ├── Views/                   # SwiftUI view components
│   │   ├── Dashboard/           # Dashboard interface
│   │   ├── Profile/             # Profile management
│   │   └── Setting/             # Settings interface
│   └── Assets.xcassets/         # Application assets
├── XiaoXiong/                   # Main application target
│   ├── DefaultUI/               # Default UI components
│   └── Info.plist               # Application configuration
├── Extension/                   # Network extension
├── SystemExtension/             # System extension for macOS
├── uuvpn.xcodeproj             # Xcode project file
└── README.md                   # Project documentation

⚙️ Installation & Setup

1. Clone the Repository

git clone https://github.com/nicolastinkl/UUVPN/tree/main/iOS-SwiftUI-Code
cd iOS-SwiftUI-Code

2. Install Dependencies

The project uses Swift Package Manager for dependency management. Note: VPN connection required for package resolution.

# Dependencies will be automatically resolved when opening the project

3. Open Project in Xcode

open uuvpn.xcodeproj

Select your target device or simulator and click the Run button.

🔧 V2Board API Configuration

Base Configuration

The application integrates with V2Board panels through a comprehensive API configuration system managed by StoreManager.swift.

Configuration URL

public let configURL = "https://api.gooapis.com/api/vpnconfig.php"

API Endpoints Configuration

Configure the following API endpoints in your initialization response:

{
  "baseURL": "https://api.0008.uk/api/v1/",
  "baseDYURL": "https://api.gooapis.com/api/vpnnodes.php",
  "mainregisterURL": "https://lelian.app/#/register?code=",
  "paymentURL": "xxxxx",
  "telegramurl": "https://t.me/fastlink",
  "kefuurl": "https://gooapis.com/fastlink/",
  "websiteURL": "https://gooapis.com/fastlink/",
  "crisptoken": "5546c6ea-4b1e-41bc-80e4-4b6648cbca76",
  "banners": [
    "https://image.gooapis.com/api/images/12-11-56.png",
    "https://image.gooapis.com/api/images/12-44-57.png",
    "https://image.gooapis.com/api/images/12-47-03.png"
  ],
  "message": "OK",
  "code": 1
}

API Field Descriptions

Field	Description	Usage
`baseURL`	Primary API endpoint for V2Board panel	All main API requests
`baseDYURL`	Default VPN node testing endpoint	Node connectivity testing
`mainregisterURL`	User registration page with referral code	User onboarding
`paymentURL`	Payment gateway URL	Critical for App Store compliance
`telegramurl`	Telegram support channel	Customer support
`kefuurl`	Customer service page	Online support
`websiteURL`	Official website URL	General information
`crisptoken`	Crisp chat authentication token	Live chat integration
`banners`	Promotional banner image URLs	Marketing content
`message`	Response status message	API response validation
`code`	Response status code	Success/error handling

API Request Headers

All API requests include the following headers for authentication and tracking:

request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue(Bundle.main.bundleIdentifier ?? "", forHTTPHeaderField: "bid")
request.addValue(UserManager.shared.appversion, forHTTPHeaderField: "appver")

🆔 Bundle Identifier (BID) Configuration

Understanding Bundle Identifier

The Bundle Identifier (BID) is crucial for app identification and API authentication. It's referenced throughout the codebase as Bundle.main.bundleIdentifier.

Current BID Configuration

Based on the Info.plist analysis, the current BID pattern is:

com.uuvpn.appleaman

Modifying Bundle Identifier

To change the Bundle Identifier for your deployment:

1. Update Xcode Project Settings

Open uuvpn.xcodeproj in Xcode
Select the project root in the navigator
Choose your target (e.g., "SFI", "SFM", "SFT")
Navigate to General → Identity
Update the Bundle Identifier field

2. Update Info.plist References

Search and replace all BID references in configuration files:

# Search for current BID references
grep -r "com.uuvpn.appleaman" .

# Update the following files:
# - XiaoXiong/Info.plist
# - Extension/Info.plist  
# - SystemExtension/Info.plist
# - IntentsExtension/Info.plist

3. Update Code References

The BID is automatically retrieved via Bundle.main.bundleIdentifier in:

No code changes required as it uses the system bundle identifier.

BID Validation in API

The server can validate requests using the BID header to ensure API calls come from authorized applications.

💳 Payment URL Logic & App Store Compliance

Payment URL Length Detection

The application implements intelligent payment handling based on the paymentURL field length:

// Apple Review Mode Detection
if (paymentURLKey.count > 3) {
    // Normal payment mode - show external payment options
    // Enable subscription features
    // Show payment buttons and pricing
} else {
    // Apple Review Mode - hide external payments
    // Comply with App Store guidelines
    // Hide sensitive payment information
}

Implementation Details

Normal Mode (paymentURL.length > 3)

External Payment: Direct users to web-based payment systems
Full Feature Access: All subscription features available
Payment Integration: Complete payment flow with external providers

Apple Review Mode (paymentURL.length ≤ 3)

Compliance Mode: Hides external payment options
Limited Features: Restricted functionality during review
App Store Guidelines: Complies with Apple's payment policies

Code Implementation

The logic is implemented across multiple view files:

HomeView.swift: Main payment UI logic
SideMenuView.swift: Menu payment options
ActiveDashboardViewNewUI.swift: Dashboard payment handling

Server-Side Configuration

Configure your initialization endpoint to return:

{
  "paymentURL": "https://your-payment-gateway.com/pay",  // Normal mode
  // OR
  "paymentURL": "xx",  // Apple review mode
}

🔄 Initialization Endpoint Configuration

Endpoint Setup

The application fetches configuration from a remote endpoint on startup. This allows dynamic configuration without app updates.

Recommended Hosting

Alibaba Cloud OSS: Faster response times in China
CDN Integration: Global content delivery
HTTPS Required: Secure configuration delivery

Configuration Response Format

{
  "baseURL": "https://your-v2board-panel.com/api/v1/",
  "baseDYURL": "https://your-node-test-endpoint.com/api/vpnnodes.php",
  "mainregisterURL": "https://your-panel.com/#/register?code=",
  "paymentURL": "https://your-payment-gateway.com/",
  "telegramurl": "https://t.me/your-support-channel",
  "kefuurl": "https://your-support-site.com/",
  "websiteURL": "https://your-website.com/",
  "crisptoken": "your-crisp-chat-token",
  "banners": [
    "https://your-cdn.com/banner1.png",
    "https://your-cdn.com/banner2.png"
  ],
  "message": "OK",
  "code": 1
}

Error Handling

{
  "message": "Configuration Error",
  "code": 0,
  "error": "Invalid request"
}

Caching Strategy

The StoreManager implements local caching:

// Configuration is cached locally using UserDefaults
func storebaseURLData(data: String) {
    defaults.set(data, forKey: "baseURLKey")
    defaults.synchronize()
}

🔐 Security Considerations

API Security

HTTPS Only: All API endpoints must use HTTPS
Token Validation: Implement proper token validation
Rate Limiting: Protect against API abuse

Bundle Identifier Security

Unique BID: Use a unique bundle identifier for your deployment
Server Validation: Validate BID on server-side for API requests
Certificate Pinning: Consider implementing certificate pinning

🚀 Deployment Guide

Pre-Deployment Checklist

Update Bundle Identifier: Change from default BID
Configure API Endpoints: Set up your V2Board panel URLs
Test Payment Logic: Verify both normal and review modes
Update App Icons: Replace default icons with your branding
Configure Push Notifications: Set up notification certificates

Build Configuration

# Clean build folder
rm -rf ~/Library/Developer/Xcode/DerivedData

# Archive for distribution
xcodebuild archive \
  -project uuvpn.xcodeproj \
  -scheme YourSchemeName \
  -archivePath YourApp.xcarchive

🤝 Contributing

We welcome contributions to improve the application. Please follow these guidelines:

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

📞 Support

For technical support and questions:

GitHub Issues: Create an issue
Documentation: Refer to the deployment documentation in the project
Community: Join our developer community for assistance

Note: This application requires proper V2Board panel setup and valid API endpoints to function correctly. Ensure your backend infrastructure is properly configured before deployment.