feat: docs

Author: okwasniewski

docs/docs/brownie/codegen.mdx

@@ -14,12 +14,11 @@ brownfield --version                 # Show version
 
 ## Configuration
 
-Add to your app's `package.json`:
+Add to your app's `package.json` (only needed for Kotlin):
 
 ```json
 {
   "brownie": {
-    "swift": "./ios/Generated/",
     "kotlin": "./android/app/src/main/java/com/example/",
     "kotlinPackageName": "com.example"
   }
@@ -28,11 +27,10 @@ Add to your app's `package.json`:
 
 | Field               | Required | Description                                                |
 | ------------------- | -------- | ---------------------------------------------------------- |
-| `swift`             | No\*     | Output directory for Swift files                           |
-| `kotlin`            | No\*     | Output directory for Kotlin files                          |
+| `kotlin`            | No       | Output directory for Kotlin files                          |
 | `kotlinPackageName` | No       | Kotlin package name (extracted from path if not specified) |
 
-\*At least one of `swift` or `kotlin` is required.
+**Note:** Swift files are always generated to `node_modules/@callstack/brownie/ios/Generated/`. This path is auto-resolved and not configurable.
 
 ## Generated Output
 
@@ -47,16 +45,18 @@ interface BrownfieldStore extends BrownieStore {
 
 ### Swift Output
 
+Generated to: `node_modules/@callstack/brownie/ios/Generated/BrownfieldStore.swift`
+
 ```swift
 import Brownie
 
-struct BrownfieldStore: Codable {
-    var counter: Double
-    var user: User
+public struct BrownfieldStore: Codable {
+    public var counter: Double
+    public var user: User
 }
 
-struct User: Codable {
-    var name: String
+public struct User: Codable {
+    public var name: String
 }
 
 extension BrownfieldStore: BrownieStoreProtocol {
@@ -66,6 +66,7 @@ extension BrownfieldStore: BrownieStoreProtocol {
 
 The generated struct:
 
+- Uses `public` access level for framework compatibility
 - Conforms to `Codable` for JSON serialization
 - Conforms to `BrownieStoreProtocol` with auto-generated `storeName`
 - Uses mutable `var` properties

docs/docs/brownie/overview.mdx

@@ -98,13 +98,13 @@ function Counter() {
 import Brownie
 
 struct ContentView: View {
-  @UseStore<AppStore> var store
+  @UseStore(\AppStore.counter) var counter
 
   var body: some View {
     VStack {
-      Text("Count: \(Int(store.state.counter))")
+      Text("Count: \(Int(counter))")
       Button("Increment") {
-        store.set { $0.counter += 1 }
+        $counter.set { $0 + 1 }
       }
     }
   }

docs/docs/brownie/store-definition.mdx

@@ -43,17 +43,17 @@ interface BrownfieldStore extends BrownieStore {
 }
 ```
 
-Generated Swift:
+Generated Swift (to `node_modules/@callstack/brownie/ios/Generated/`):
 
 ```swift
-struct BrownfieldStore: Codable {
-    var counter: Double
-    var user: User
+public struct BrownfieldStore: Codable {
+    public var counter: Double
+    public var user: User
 }
 
-struct User: Codable {
-    var name: String
-    var email: String
+public struct User: Codable {
+    public var name: String
+    public var email: String
 }
 ```
 

packages/brownie/ArchitectureOverview.md

@@ -48,7 +48,6 @@ Add to your app's `package.json`:
 ```json
 {
   "brownie": {
-    "swift": "./ios/Generated/",
     "kotlin": "./android/app/src/main/java/com/example/",
     "kotlinPackageName": "com.example"
   }
@@ -57,11 +56,10 @@ Add to your app's `package.json`:
 
 | Field               | Required | Description                               |
 | ------------------- | -------- | ----------------------------------------- |
-| `swift`             | No\*     | Output directory for Swift files          |
-| `kotlin`            | No\*     | Output directory for Kotlin files         |
+| `kotlin`            | No       | Output directory for Kotlin files         |
 | `kotlinPackageName` | No       | Kotlin package name (extracted from path) |
 
-\*At least one of `swift` or `kotlin` is required.
+**Note:** Swift files are always generated to `node_modules/@callstack/brownie/ios/Generated/`. This path is auto-resolved and not configurable.
 
 ### Store Definition
 
@@ -110,16 +108,18 @@ declare module '@callstack/brownie' {
 
 ### Generated Output
 
-**Swift** (`Codable` struct with mutable properties):
+**Swift** (`Codable` struct with public access and mutable properties):
 
 ```swift
-struct BrownfieldStore: Codable {
-    var counter: Double
-    var isLoading: Bool
-    var user: String
+public struct BrownfieldStore: Codable {
+    public var counter: Double
+    public var isLoading: Bool
+    public var user: String
 }
 ```
 
+Generated to: `node_modules/@callstack/brownie/ios/Generated/BrownfieldStore.swift`
+
 **Kotlin** (data class):
 
 ```kotlin
@@ -185,7 +185,9 @@ packages/brownie/
 ├── ios/
 │   ├── BrownieModule.h/.mm        # TurboModule, installs JSI bindings
 │   ├── BrownieStoreBridge.h/.mm   # ObjC++ wrapper for Swift access
-│   └── BrownieStore.swift         # Swift Store<T>, StoreManager, @UseStore
+│   ├── BrownieFollyConvert.h      # FollyConvert import compatibility header
+│   ├── BrownieStore.swift         # Swift Store<T>, StoreManager, @UseStore
+│   └── Generated/                 # Auto-generated Swift store types (codegen output)
 ```
 
 ### C++ Core
@@ -216,6 +218,13 @@ packages/brownie/
 
 ### iOS Bridge
 
+**BrownieFollyConvert.h** - Compatibility header for FollyConvert imports:
+
+- Handles different import paths depending on CocoaPods configuration
+- Supports static libs with header maps (default)
+- Supports `use_frameworks! :linkage => :static` setups
+- Falls back to `RCTFollyConvert.h` when available
+
 **BrownieStoreBridge** (ObjC++) - Exposes C++ to Swift:
 
 - `registerStore(withKey:)` - Create C++ store, set up notification callback