stack/sdks/implementations/swift/Examples/StackAuthiOS

Hexclave iOS Example

An interactive iOS application for testing all Hexclave Swift SDK functions.

Prerequisites

• Xcode 15.0 or later
• iOS 17.0+ Simulator or device
• Running Hexclave backend (default: http://localhost:8102)

Running the Example

Option 1: Xcode

1. Open the project in Xcode:

   open StackAuthiOS.xcodeproj
   

2. Select an iOS Simulator (e.g., "iPhone 15 Pro" or any available device) as the destination

3. Press ⌘R to build and run

Option 2: Command Line

# Build (replace device name with an available simulator on your system)
xcodebuild -scheme StackAuthiOS -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build

# Build and run (opens simulator)
xcodebuild -scheme StackAuthiOS -destination 'platform=iOS Simulator,name=iPhone 15 Pro' run

Features

The app uses a tab-based interface optimized for mobile:

• Settings: Configure API endpoint, project ID, and keys
• Auth: Sign up, sign in, sign out, get current user
• User: Update display name, metadata, view tokens
• Teams: Create, list, and manage teams
• Logs: View all SDK calls with full details (tap for more, long-press to copy)

Additional functions are accessible via navigation links in Settings:

• Contact Channels
• OAuth URL generation
• Token operations
• Server Users (admin)
• Server Teams (admin)
• Sessions (impersonation)

SDK Functions Covered

Client App

• signUpWithCredential(email:password:)
• signInWithCredential(email:password:)
• signOut()
• getUser() / getUser(or:)
• getAccessToken() / getRefreshToken()
• getAuthHeaders()
• getOAuthUrl(provider:)

Current User

• setDisplayName(_:)
• update(clientMetadata:)
• listTeams() / getTeam(id:)
• createTeam(displayName:)
• listContactChannels()

Server App

• createUser(email:password:...)
• listUsers(limit:)
• getUser(id:)
• createTeam(displayName:)
• listTeams()
• createSession(userId:)

Logging

The Logs tab shows all SDK activity in real-time:

• Green checkmark: Successful calls with full response data
• Red X: Errors with details
• Blue info: In-progress calls

Tap any log entry to see full details. Long-press to copy to clipboard.

Network Configuration

For iOS Simulator to connect to your local backend:

1. The default localhost:8102 should work in the simulator
2. For a real device, use your computer's local IP address instead

Troubleshooting

"Could not connect to server"

• Ensure your Hexclave backend is running
• Check the Base URL in Settings tab
• For real devices, use your computer's IP instead of localhost

Build errors

• Make sure you have Xcode 15+ installed
• Try cleaning: Product → Clean Build Folder (⇧⌘K)