Skip to content
replica882Public

About

Looks like iOS. Isn't. An iPhone Home Screen and app switcher recreated in SwiftUI.

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

iOSn't logo, a hand-drawn sketch

iOSn't

Looks like iOS. Isn't.

English · 简体中文

Calling all Apple fans! A look-alike iOS 26+ Home Screen (a tiny phone inside your phone?), built in SwiftUI and UIKit. Just the shell and the app switcher.

It's maybe 95% there? Some of the motion details are still off, because Apple really does set the bar. The last few percent aren't worth the effort, so I'll leave them to the experts to tinker with!

Everything you'd touch on a real Home Screen works: pages, the Dock, the App Library, jiggle-mode editing, folders, widget stacks, and a multitasking switcher you open by dragging a corner arc. The apps behind the icons are placeholders, so you can drop in your own screens.

It's also the Page 2 app screen of Mneme Atrium. Please give Mneme Atrium a follow, meow. Thank you, meow!

Dragging the corner arc into the app switcher
Corner arc and app switcher
Creating a folder, then resizing and stacking widgets
Folders, resizing, and widget stacks
Searching and browsing the App Library
Search and the App Library

Recorded on an iPhone with the interface set to Chinese.

Highlights

  • Home Screen: multiple pages, a Dock, and the App Library with categories and A–Z search. Search matches English names and pinyin for Chinese names.
  • Editing: touch and hold to enter jiggle mode. Drag icons around, drop one onto another to make a folder, resize widgets, and stack them.
  • App switcher: inside an app, drag the arc in the top-left corner. A short drag opens the switcher; a long drag or a touch-and-hold goes home.
    • Up to four apps stay in the background. One app shows as a large card, several as a two-column grid.
    • Tap a card to resume it. Swipe it up or tap its × to close. Tap empty space to go home.
  • Motion details: the Dock and page dots slide away with the last page when you enter the App Library. App state such as the placeholder counter survives trips through the switcher.
  • Customization: built-in gradient wallpapers or your own photo, per-icon symbols and colors, and default, dark, clear, and tinted icon styles. The layout is saved on device.
  • Two languages: English (default) and Simplified Chinese. Switch between them in the Settings app on the mimic Home Screen. The change applies instantly.

Getting started

You need macOS with Xcode 26 or later (iOS 26 SDK) and XcodeGen. There are no third-party packages, no backend, and no accounts.

brew install xcodegen
xcodegen generate
open iOSnt.xcodeproj

Pick the iOSnt scheme and an iPhone simulator, then run. The app is portrait-only iPhone. On a real device, set your own team and a unique bundle identifier under Signing & Capabilities.

The generated .xcodeproj is not committed. project.yml is the source of truth, so run xcodegen generate again after adding files.

Command-line build and test

Find a simulator ID with xcrun simctl list devices available, then:

bash scripts/xcodebuild-lock.sh -project iOSnt.xcodeproj -scheme iOSnt \
  -destination 'platform=iOS Simulator,id=<SIMULATOR_UUID>' build CODE_SIGNING_ALLOWED=NO
bash scripts/xcodebuild-lock.sh -project iOSnt.xcodeproj -scheme iOSnt \
  -destination 'platform=iOS Simulator,id=<SIMULATOR_UUID>' \
  -parallel-testing-enabled NO test CODE_SIGNING_ALLOWED=NO
python3 scripts/check-source.py

xcodebuild-lock.sh wraps xcodebuild with a cross-process lock (default /tmp/mp-xcodebuild.lock), so parallel local builds wait their turn. check-source.py checks that the sources are self-contained and that every UI string has a translation.

Make it your own

Where What
Sources/Demo/DemoAppCatalog.swift The sample apps (id, name, SF Symbol) and DemoAppView, which picks the screen each app shows. Route an app id to your own view here.
Sources/Demo/DemoSettingsView.swift The Settings app, the only sample app with a real screen.
Sources/Desktop/DesktopWidgetHost.swift Static sample widgets and stacks.
DesktopHomeStore, DesktopGridEngine Layout persistence and grid placement.
DesktopAppShellView, DesktopAppMotion, DesktopCornerBar, DesktopAppSwitcherView Background apps, the corner arc, the switcher, and their animations.

The placeholder counter is there to show that view state survives the switcher. It is not saved across launches. The app uses the bundle id com.example.iosnt, and layouts and imported images stay in its own sandbox.

Localization

UI text is written in English in code and wrapped in L("…"). Translations live in Sources/Resources/Localizable.xcstrings. L looks strings up in the language picked in Settings instead of the system language, so switching needs no relaunch. System-provided controls (the search field's Cancel button, the photo and file pickers) follow the choice from the next launch.

To add a language, add a case to AppLanguage in Sources/App/AppLanguage.swift and add its translations to the catalog. python3 scripts/check-source.py fails if a L("…") key has no Chinese translation, or if Chinese text is hard-coded in the sources.

Limitations

  • This is a Home Screen simulation inside a regular iOS app. It cannot replace SpringBoard or launch other installed apps. Switcher cards are in-memory snapshots of the placeholder views.
  • iOS only lets an app ask to defer the system's top-edge gestures, not disable them. Conflicts with Notification Center on a real device still need testing.
  • Built for a single window on a portrait iPhone. Screen corner radii are approximated from the device size, so other models and iOS versions may need tuning.
  • To keep the drag-and-drop behavior, the app observes UIApplication.sendEvent and forwards touches through an Objective-C method exchange. No private selectors are used, but watch for other event observers if you embed it elsewhere.

See docs/verification.md for what has been tested and CONTRIBUTING.md for contribution guidelines.

License and assets

The code is released under the MIT License. The project ships no Apple wallpapers, branded app icons, photos of people, or data from the project it was extracted from. The interface uses SF Symbols provided by the system at runtime; they are not covered by this project's MIT license. Images you import are your own choice. The iOSn't logo and app icon are hand-drawn by the maintainer.

This project is not affiliated with or endorsed by Apple. For where the code came from and how it was adapted, see docs/provenance.md (in Chinese).

About

Looks like iOS. Isn't. An iPhone Home Screen and app switcher recreated in SwiftUI.

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages