Updating Package 4.0.0

Author: Anka

README.md

@@ -1,5 +1,23 @@
 # SwiftMockzilla
 
-This repository exists to host the SPM package for Mockzilla. 
+[![License](https://img.shields.io/github/license/Apadmi-Engineering/SwiftMockzilla)](LICENSE)
 
-For documentation, issues, feedback and everything else, please see the main repository [here](https://github.com/Apadmi-Engineering/Mockzilla).
+This repository hosts the Swift Package Manager (SPM) wrapper around Mockzilla's `mockzilla.xcframework` binary, for use in native iOS apps. It's a distribution package only — source, issues, and contributions all live in the [main Mockzilla repository](https://github.com/Apadmi-Engineering/Mockzilla).
+
+Mockzilla is a compile-safe mock HTTP server you run embedded in your app during development/testing, so you can mock API responses without a real backend — see the [main README](https://github.com/Apadmi-Engineering/Mockzilla#readme) for the full pitch.
+
+## Installation
+
+In Xcode: **File > Swift Packages > Add Package Dependency**, then add:
+
+```
+https://github.com/Apadmi-Engineering/SwiftMockzilla.git
+```
+
+> This package is for native iOS apps. If you're using Kotlin Multiplatform, add the `com.apadmi:mockzilla` Gradle dependency to your shared source set instead.
+
+## Documentation
+
+Full setup and usage docs are at [mockzilla.apadmi.dev](https://mockzilla.apadmi.dev/quick-start/).
+
+For documentation, issues, feedback and everything else, please see the [main repository](https://github.com/Apadmi-Engineering/Mockzilla).

SwiftMockzilla.podspec

@@ -1,8 +1,8 @@
 Pod::Spec.new do |spec|
     spec.name                     = 'SwiftMockzilla'
-    spec.version                  = '4.0.0-alpha1'
+    spec.version                  = '4.0.0'
     spec.homepage                 = 'https://mockzilla.apadmi.dev/'
-    spec.source                   = { :git => 'https://github.com/Apadmi-Engineering/SwiftMockzilla.git', :tag => 'v4.0.0-alpha1' }
+    spec.source                   = { :git => 'https://github.com/Apadmi-Engineering/SwiftMockzilla.git', :tag => 'v4.0.0' }
     spec.authors                  = ''
     spec.license                  = {:type => 'MIT', :file => 'LICENSE'}
     spec.summary                  = 'A solution for running and configuring a local HTTP server to mimic REST API endpoints used by your application.'