Skip to content

timokoethe/Localframe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Localframe for iOS 26

License: MIT Framework Platform Xcode iOS Apple

Localframe is a small SwiftUI showcase app for experimenting with Apple’s Image Playground framework on iOS 26. It demonstrates how to create an ImageCreator, stream generated images from a text prompt, and present the result in a minimal native interface.

This project is intentionally lightweight. It is meant to document and demonstrate the API shape, not to serve as a production image generation product.

⚠️ Important status

Showcase only

Localframe is a demonstration project. It is not production-ready, not maintained as a compatibility layer, and generated output may be inaccurate, incomplete, or misleading.

iOS 27 warning

This app uses Apple’s ImageCreator class. Apple announced on June 11, 2026 that ImageCreator is discontinued and will no longer work on iOS 27, iPadOS 27, macOS 27, and visionOS 27 or later.

What that means for this repository:

  • iOS 26 is the intended showcase target.
  • iOS 27 beta builds may compile with warnings, but ImageCreator features can fail at runtime.
  • Public iOS 27 SDKs are expected to stop compiling code that depends on ImageCreator.
  • For iOS 27+, Apple recommends presenting the system-managed Image Playground sheet or using another image generation service.

See Apple’s announcement: Deprecation of the ImageCreator class.

✨ Features

  • 🖼️ Image Playground integration: Uses Apple’s ImageCreator API.
  • 🌊 Streaming results: Consumes generated images asynchronously as they arrive.
  • 🧑‍🎨 Minimalist Prompt UI: Clean SwiftUI interface for crafting prompts and viewing output.
  • 🗑️ No persistent storage: Generated images are kept in memory only and are not saved by the app.

Requirements

  • Xcode 26
  • iOS 26 deployment target
  • A real Apple Intelligence-compatible iPhone
  • Apple Intelligence enabled on the device
  • Supported device and Siri language

The iOS Simulator is not a supported runtime for Image Playground image generation. If you run the app in Simulator, ImageCreator can return .notSupported.

Known limitations

  • Image generation does not work in the iOS Simulator.
  • The app targets iOS 26 and depends on ImageCreator.
  • ImageCreator is discontinued for iOS 27 and later.
  • Error handling is intentionally minimal for showcase purposes.

🛠 API walkthrough

Import the framework

import ImagePlayground

Create an ImageCreator

do {
    self.imageCreator = try await ImageCreator()
} catch {
    self.error = error as? ImageCreator.Error
}

Generate images

guard let imageCreator else { return }

let images = imageCreator.images(
    for: [.text(inputPrompt)],
    style: selectedStyle,
    limit: 2
)

Display streamed results

for try await image in images {
    generatedCGImages.append(image.cgImage)
}

License

Localframe is available under the MIT License. See LICENSE for the full license text.

About

A SwiftUI-based iOS 26 app featuring a fully local image creator powered by Apple’s Image Playground Models. Private, fast, and cloud-free.

Topics

Resources

License

Security policy

Stars

8 stars

Watchers

0 watching

Forks

Contributors

Languages