Update README and Fastfile with detailed usage examples and features for Instabug plugin

Author: ahmedhany98

README.md

@@ -12,15 +12,87 @@ fastlane add_plugin instabug-stores-upload
 
 ## About instabug-stores-upload
 
-Wrapper plugin for uploading builds to App Store and Play Store with Instabug-specific metadata reporting.
+Wrapper plugin for uploading builds to App Store and Play Store with Instabug-specific metadata reporting. This plugin provides custom actions that wrap the standard Fastlane actions and automatically report build and upload events to Instabug systems for better observability and integration into internal pipelines.
 
-**Note to author:** Add a more detailed description about this plugin here. If your plugin contains multiple actions, make sure to mention them here.
+### Available Actions
+
+- `instabug_build_ios_app` - Build iOS apps with Instabug reporting
+- `instabug_build_android_app` - Build Android apps with Instabug reporting
+- `instabug_upload_to_app_store` - Upload iOS builds to App Store with Instabug reporting
+- `instabug_upload_to_play_store` - Upload Android builds to Play Store with Instabug reporting
+
+### Features
+
+- Automatic reporting of build and upload events to Instabug
+- Branch-based tracking for Instabug Agents observability
+- Integration with existing Fastlane workflows
+- Support for both iOS and Android platforms
+- Secure API communication with Instabug services
 
 ## Example
 
 Check out the [example `Fastfile`](fastlane/Fastfile) to see how to use this plugin. Try it by cloning the repo, running `fastlane install_plugins` and `bundle exec fastlane test`.
 
-**Note to author:** Please set up a sample project to make it easy for users to explore what your plugin does. Provide everything that is necessary to try out the plugin in this project (including a sample Xcode/Android project if necessary)
+### Usage Examples
+
+#### iOS Build
+```ruby
+lane :build_ios do
+  instabug_build_ios_app(
+    branch_name: "main",
+    instabug_api_key: ENV["INSTABUG_API_KEY"],
+    workspace: "MyApp.xcworkspace",
+    scheme: "MyApp",
+    export_method: "app-store",
+    configuration: "Release"
+  )
+end
+```
+
+#### Android Build
+```ruby
+lane :build_android do
+  instabug_build_android_app(
+    branch_name: "main",
+    instabug_api_key: ENV["INSTABUG_API_KEY"],
+    task: "assembleRelease",
+    project_dir: "android/",
+    properties: {
+      "android.injected.signing.store.file" => "keystore.jks",
+      "android.injected.signing.store.password" => ENV["KEYSTORE_PASSWORD"],
+      "android.injected.signing.key.alias" => "key0",
+      "android.injected.signing.key.password" => ENV["KEY_PASSWORD"]
+    }
+  )
+end
+```
+
+#### iOS Upload
+```ruby
+lane :upload_ios do
+  instabug_upload_to_app_store(
+    branch_name: "main",
+    instabug_api_key: ENV["INSTABUG_API_KEY"],
+    ipa: "path/to/your/app.ipa",
+    skip_screenshots: true,
+    skip_metadata: true
+  )
+end
+```
+
+#### Android Upload
+```ruby
+lane :upload_android do
+  instabug_upload_to_play_store(
+    branch_name: "main",
+    instabug_api_key: ENV["INSTABUG_API_KEY"],
+    package_name: "com.example.app",
+    aab: "path/to/your/app.aab",
+    track: "internal",
+    skip_upload_screenshots: true
+  )
+end
+```
 
 ## Run tests for this plugin
 

fastlane/Fastfile

@@ -1,5 +1,39 @@
 # Fastfile for Instabug Stores Upload Plugin
 
+# Example lane for building iOS app with Instabug reporting
+lane :build_ios_app do |options|
+  branch_name = options[:branch_name]
+  
+  instabug_build_ios_app(
+    branch_name: branch_name,
+    instabug_api_key: ENV["INSTABUG_API_KEY"],
+    # All standard build_ios_app parameters are supported
+    workspace: "MyApp.xcworkspace",
+    scheme: "MyApp",
+    export_method: "app-store",
+    configuration: "Release"
+  )
+end
+
+# Example lane for building Android app with Instabug reporting
+lane :build_android_app do |options|
+  branch_name = options[:branch_name]
+  
+  instabug_build_android_app(
+    branch_name: branch_name,
+    instabug_api_key: ENV["INSTABUG_API_KEY"],
+    # All standard gradle parameters are supported
+    task: "assembleRelease",
+    project_dir: "android/",
+    properties: {
+      "android.injected.signing.store.file" => "keystore.jks",
+      "android.injected.signing.store.password" => ENV["KEYSTORE_PASSWORD"],
+      "android.injected.signing.key.alias" => "key0",
+      "android.injected.signing.key.password" => ENV["KEY_PASSWORD"]
+    }
+  )
+end
+
 # Example lane for uploading to App Store with Instabug reporting
 lane :upload_to_app_store do |options|
   branch_name = options[:branch_name]
@@ -24,4 +58,4 @@ lane :upload_to_play_store do |options|
     aab: "path/to/your/app.aab",
     track: "internal"
   )
-end
+end