tahatesser/spt

Requirements

• iOS 17.0+ / macOS 14.0+
• Swift 6.0+

Installation

Add SPT to your project via Swift Package Manager:

1. Open your project in Xcode
2. Navigate to File > Add Package Dependencies
3. Enter the following URL:

https://github.com/TahaTesser/SPT.git

Setup

Configure SPT early in your app lifecycle:

import SwiftUI
import SPT

@main
struct MyApp: App {
    init() {
        SPT.configure(.init(
            slowViewThreshold: 16.0, // ms (default, ~1 frame at 60fps)
            loggingEnabled: true
        ))
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Usage

Measure View Construction Time

SPT measures how long it takes to construct view hierarchies (evaluate view expressions), not the rendering or layout phases managed by SwiftUI.

Modifier Style (.sptProfile)

Use for simple view wrapping:

struct HomeView: View {
    var body: some View {
        VStack {
            HeaderView()
            ContentView()
        }
        .sptProfile("HomeView")
    }
}

Container Style (SPTProfile)

Use when you need to measure expensive work during body evaluation:

struct ExpensiveView: View {
    var body: some View {
        SPTProfile(name: "ExpensiveView") {
            let data = expensiveComputation()
            MyContentView(data: data)
        }
    }
}

Explicit Measurement Type

Both APIs accept an optional measuring parameter (defaults to .viewBody):

.sptProfile("HomeView", measuring: .viewBody)

SPTProfile(name: "ExpensiveView", measuring: .viewBody) {
    // content
}

When view construction exceeds the threshold, SPT logs a warning:

[SPT] Slow view construction: HomeView - 23.7ms (threshold: 16.0ms)

Configuration Options

| Option | Default | Description | |--------|---------|-------------| | slowViewThreshold | 16.0 | Duration in ms that triggers a warning | | loggingEnabled | true | Enable/disable logging |

Package Metadata

Repository: tahatesser/spt

Default branch: main

README: README.md