Update with Dev

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "wiki"]
-	path = wiki
-	url = https://github.com/Aeastr/Portal.wiki.git

Package.swift

@@ -19,7 +19,7 @@ let package = Package(
     ],
     dependencies: [
         .package(url: "https://github.com/Aeastr/Chronicle.git", from: "3.0.1"),
-        .package(url: "https://github.com/Aeastr/Obfuscate.git", from: "1.0.0")
+        .package(url: "https://github.com/Aeastr/UIPortalBridge.git", from: "1.0.0")
     ],
     targets: [
         .target(
@@ -42,7 +42,7 @@ let package = Package(
             name: "_PortalPrivate",
             dependencies: [
                 "PortalTransitions",
-                .product(name: "Obfuscate", package: "Obfuscate")
+                .product(name: "UIPortalBridge", package: "UIPortalBridge")
             ],
             path: "Sources/_PortalPrivate"
         ),

README.md

@@ -1,48 +1,59 @@
 <div align="center">
-  <img width="200" height="200" src="/Resources/icon/icon.png" alt="Portal Logo">
+  <img width="128" height="128" src="/resources/icon/icon.png" alt="Portal Icon">
   <h1><b>Portal</b></h1>
   <p>
     Element transitions across navigation contexts, scroll-based flowing headers, and view mirroring for SwiftUI.
   </p>
 </div>
 
 <p align="center">
-  <a href="https://developer.apple.com/ios/"><img src="https://img.shields.io/badge/iOS-17%2B-purple.svg" alt="iOS 17+"></a>
-  <a href="https://swift.org/"><img src="https://img.shields.io/badge/Swift-6.2-orange.svg" alt="Swift 6.2"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"></a>
+  <a href="https://swift.org"><img src="https://img.shields.io/badge/Swift-6.2+-F05138?logo=swift&logoColor=white" alt="Swift 6.2+"></a>
+  <a href="https://developer.apple.com"><img src="https://img.shields.io/badge/iOS-17+-000000?logo=apple" alt="iOS 17+"></a>
   <a href="https://github.com/Aeastr/Portal/actions/workflows/build.yml"><img src="https://github.com/Aeastr/Portal/actions/workflows/build.yml/badge.svg" alt="Build"></a>
   <a href="https://github.com/Aeastr/Portal/actions/workflows/tests.yml"><img src="https://github.com/Aeastr/Portal/actions/workflows/tests.yml/badge.svg" alt="Tests"></a>
 </p>
 
 <div align="center">
-  <img width="600" src="/Resources/examples/example1.gif" alt="Portal Demo">
+  <img width="600" src="/resources/examples/example1.gif" alt="Preview">
 </div>
 
 
+## Overview
+
+Portal provides three modules for different use cases:
+
+- **PortalTransitions** — Animate views between navigation contexts (sheets, navigation stacks, tabs) using a floating overlay layer. Uses standard SwiftUI APIs.
+- **PortalHeaders** — Scroll-based header transitions that flow into the navigation bar, like Music or Photos. Uses iOS 18's advanced scroll tracking APIs.
+- **_PortalPrivate** — True view mirroring using Apple's private `_UIPortalView` API. The view instance is shared rather than recreated.
+
+
+## Requirements
+
+- Swift 6.2+
+- iOS 17+ (PortalTransitions)
+- iOS 18+ (PortalHeaders)
+
+> Targeting iOS 15/16? Pin to `v2.1.0` or the `legacy/ios15` branch.
+
+
 ## Installation
 
 ```swift
 dependencies: [
-    .package(url: "https://github.com/Aeastr/Portal", from: "4.0.0")
+    .package(url: "https://github.com/Aeastr/Portal.git", from: "4.0.0")
 ]
 ```
 
-Then import the module you need:
-
-```swift
-import PortalTransitions  // Element transitions (iOS 17+)
-import PortalHeaders      // Flowing headers (iOS 18+)
-import _PortalPrivate     // View mirroring with private API
-```
-
-> Targeting iOS 15/16? Pin to `v2.1.0` or the `legacy/ios15` branch.
-
+| Target | Description |
+|--------|-------------|
+| `PortalTransitions` | Element transitions (iOS 17+) |
+| `PortalHeaders` | Flowing headers (iOS 18+) |
+| `_PortalPrivate` | View mirroring with private API |
 
-## Modules
 
-### PortalTransitions
+## Usage
 
-Animate views between navigation contexts — sheets, navigation stacks, tabs — using a floating overlay layer.
+### Element Transitions
 
 ```swift
 // 1. Wrap your app in PortalContainer
@@ -67,11 +78,7 @@ Image("cover")
 
 The view animates smoothly from source to destination when the cover presents, and back when it dismisses.
 
-**iOS 17+** · Uses standard SwiftUI APIs
-
----
-
-### PortalHeaders
+### Flowing Headers
 
 Scroll-based header transitions that flow into the navigation bar, like Music or Photos.
 
@@ -80,7 +87,6 @@ NavigationStack {
     ScrollView {
         PortalHeaderView()
 
-        // Your content
         ForEach(items) { item in
             ItemRow(item: item)
         }
@@ -90,28 +96,55 @@ NavigationStack {
 .portalHeader(title: "Favorites", subtitle: "Your starred items")
 ```
 
-As the user scrolls, the title transitions from inline to the navigation bar with configurable snapping behavior.
-
-**iOS 18+** · Uses advanced scroll tracking APIs
-
----
-
-### _PortalPrivate
+### Private API Mirroring
 
 > **WARNING: Private API Usage**
 >
-> This module uses Apple's private `_UIPortalView` API. Apps using private APIs **may be rejected by App Store Review**. Use at your own discretion. Portal, Aether, and any maintainers assume no responsibility for App Store rejections, app crashes, or any other issues arising from the use of this module. By importing `_PortalPrivate`, you accept full responsibility for any consequences.
+> This module uses Apple's private `_UIPortalView` API. Apps using private APIs **may be rejected by App Store Review**. Use at your own discretion. Portal, Aether, and any maintainers assume no responsibility for App Store rejections, app crashes, or any other issues arising from the use of this module.
 
 Same API as PortalTransitions, but uses Apple's private `_UIPortalView` for true view mirroring instead of layer snapshots. The view instance is shared rather than recreated.
 
-Class names are obfuscated at compile-time. See the [wiki](wiki/_PortalPrivate.md) for details.
+Class names are obfuscated at compile-time. See the [docs](docs/PortalPrivate.md) for details.
 
 
-## Documentation
+## Customization
+
+### Layer Configuration
 
-The **[Portal Wiki](https://github.com/Aeastr/Portal/wiki)** has full guides and API reference for each module.
+Customize the animating layer with optional configuration closures:
 
-The wiki is included at `/wiki` when you clone, so it's available offline.
+```swift
+// No config — frame/offset handled automatically
+.portalTransition(item: $selectedBook) { book in
+    Image("cover")
+}
+
+// Styling only — add clips, shadows, etc. (frame/offset still automatic)
+.portalTransition(item: $selectedBook) { book in
+    Image("cover")
+} configuration: { content, isActive in
+    content.clipShape(.rect(cornerRadius: isActive ? 0 : 12))
+}
+
+// Full control — you handle frame/offset (for custom modifier ordering)
+.portalTransition(item: $selectedBook) { book in
+    Image("cover")
+} configuration: { content, isActive, size, position in
+    content
+        .frame(width: size.width, height: size.height)
+        .clipShape(.rect(cornerRadius: isActive ? 0 : 12))
+        .offset(x: position.x, y: position.y)
+}
+```
+
+
+## How It Works
+
+PortalTransitions creates a transparent `PassThroughWindow` that sits above your entire app UI. Source and destination views register their bounds via `PreferenceKey`. When a transition triggers, the view is rendered in this overlay window and animated between the two positions. The window uses a custom `hitTest` implementation that only captures touches on the animated layer itself—all other touches pass through to your app below, so interaction remains seamless during animations.
+
+PortalHeaders tracks scroll position using iOS 18's `ScrollGeometry` and interpolates between inline and navigation bar states based on content offset thresholds.
+
+_PortalPrivate wraps Apple's private `_UIPortalView` class, which creates a portal to another view's layer. Class names are obfuscated at compile-time to avoid detection. See [UIPortalBridge](https://github.com/Aeastr/UIPortalBridge) for a standalone wrapper.
 
 
 ## Examples
@@ -125,11 +158,25 @@ Each module includes working examples in `Sources/*/Examples/`:
 | [Grid Carousel](Sources/PortalTransitions/Examples/PortalExampleGridCarousel.swift) | [No Accessory](Sources/PortalHeaders/Examples/PortalHeaderExampleNoAccessory.swift) | [Comparison](Sources/_PortalPrivate/Transitions/Examples/PortalPrivateExampleComparison.swift) |
 
 
+## Documentation
+
+Full guides and API reference are available in the [docs](docs/) folder.
+
+
 ## Contributing
 
 Contributions welcome. See the [Contributing Guide](CONTRIBUTING.md) for details.
 
-Released under the [MIT License](LICENSE.md).
+
+## License
+
+MIT. See [LICENSE](LICENSE.md) for details.
+
+
+## Related
+
+- [UIPortalBridge](https://github.com/Aeastr/UIPortalBridge) - Standalone wrapper for `_UIPortalView`
+- [Transmission](https://github.com/nathantannar4/Transmission) - UIKit-backed presentation and transitions for SwiftUI
 
 
 ## Contact
@@ -138,5 +185,3 @@ Released under the [MIT License](LICENSE.md).
 - [Threads](https://www.threads.net/@aetheraurelia)
 - [Bluesky](https://bsky.app/profile/aethers.world)
 - [LinkedIn](https://www.linkedin.com/in/willjones24)
-
-<p align="center">Built with 🍏🌀🚪 by Aether</p>