@acertijosapps/react-native-in-app-store-review 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2026-09-11
+
+### Changed
+
+- **Renombrado el paquete** de `@bgoswaldo/react-native-in-app-store-review` a
+  `@acertijosapps/react-native-in-app-store-review`. El paquete anterior queda
+  obsoleto (`npm deprecate`); actualiza el import y la dependencia al nuevo
+  nombre. El código y la API pública no cambian.
+
+## [1.0.5] - 2026-08-18
+
+### Changed
+
+- Mejorada la `description` de npm con términos de búsqueda (rate/review,
+  in-app) y afinados los `keywords` para descubribilidad.
+
+## [1.0.4] - 2026-08-18
+
+### Changed
+
+- Ampliados los `keywords` de npm para mejorar la búsqueda/descubribilidad.
+
+## [1.0.3] - 2026-08-17
+
+### Fixed
+
+- README: la ilustración usa la URL absoluta del raw de GitLab para que se
+  muestre en npmjs.com (las rutas relativas no se reescriben bien para GitLab).
+
+## [1.0.2] - 2026-08-17
+
+### Changed
+
+- Rutas del repositorio (`repository`, `homepage`, `bugs` y `s.source` del
+  podspec) apuntando al repo público `acertijoslibs/rninappstorereview`.
+
+## [1.0.1] - 2026-08-16
+
+### Added
+
+- README: ilustración del prompt nativo de reseña en iOS
+  (`SKStoreReviewController`) y Android (Play In-App Review), en
+  `assets/demo.png` / `assets/demo.svg`.
+
+## [1.0.0] - 2026-08-12
+
+Primera versión pública.
+
+### Added
+
+- API JS `requestReview(options?)`, `openStoreReview(options)` e
+  `isReviewSupported()` con tipos TypeScript.
+- Bridge nativo iOS con `SKStoreReviewController`
+  (`RNInAppStoreReview.swift` / `.m`), expuesto como promesa.
+- Bridge nativo Android con Play In-App Review
+  (`com.google.android.play:review-ktx`), expuesto como promesa.
+- Fallback automático a la ficha de la tienda (App Store / Play Store) cuando el
+  módulo nativo no está enlazado.
+- Empaquetado con `react-native-builder-bob` (salidas CommonJS, ESM y tipos) y
+  autolinking para iOS (podspec) y Android (Gradle).
+
+[1.1.0]: https://gitlab.com/acertijoslibs/rninappstorereview/-/tags/v1.1.0
+[1.0.5]: https://gitlab.com/acertijoslibs/rninappstorereview/-/tags/v1.0.5
+[1.0.4]: https://gitlab.com/acertijoslibs/rninappstorereview/-/tags/v1.0.4
+[1.0.3]: https://gitlab.com/acertijoslibs/rninappstorereview/-/tags/v1.0.3
+[1.0.2]: https://gitlab.com/acertijoslibs/rninappstorereview/-/tags/v1.0.2
+[1.0.1]: https://gitlab.com/acertijoslibs/rninappstorereview/-/tags/v1.0.1
+[1.0.0]: https://gitlab.com/acertijoslibs/rninappstorereview/-/tags/v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bgoswaldo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# @acertijosapps/react-native-in-app-store-review
+
+Ask users to rate your app **without leaving it**, using each platform's native
+in-app review flow:
+
+- **iOS** → [`SKStoreReviewController`](https://developer.apple.com/documentation/storekit/skstorereviewcontroller)
+- **Android** → [Play In-App Review](https://developer.android.com/guide/playcore/in-app-review) (`com.google.android.play:review-ktx`)
+
+If the native module isn't available (e.g. Expo Go, or before you rebuild), it
+falls back to opening the store listing.
+
+![In-app review prompt on iOS and Android](https://gitlab.com/acertijoslibs/rninappstorereview/-/raw/main/assets/demo.png)
+
+> Illustration of the native review prompt: iOS `SKStoreReviewController` (left)
+> and Android Play In-App Review (right).
+
+## Install
+
+```bash
+npm install @acertijosapps/react-native-in-app-store-review
+# or
+yarn add @acertijosapps/react-native-in-app-store-review
+```
+
+### iOS
+
+```bash
+cd ios && pod install
+```
+
+### Android
+
+No manual steps — the module is autolinked.
+
+> Minimum: iOS 13+, `minSdkVersion` 21+. Uses a legacy bridge module, which works
+> under both the old and the New Architecture (via the interop layer).
+
+## Usage
+
+```ts
+import { requestReview } from '@acertijosapps/react-native-in-app-store-review';
+
+// Call it after a positive moment in your app (task completed, level cleared…),
+// never on app launch, and don't gate a feature behind it.
+await requestReview({
+  iosAppId: '1234567890',      // used only by the store fallback
+  androidPackage: 'com.acme.app', // used only by the store fallback
+});
+```
+
+### API
+
+```ts
+function requestReview(options?: RequestReviewOptions): Promise<void>;
+function openStoreReview(options: RequestReviewOptions): Promise<void>;
+function isReviewSupported(): boolean;
+
+interface RequestReviewOptions {
+  iosAppId?: string;       // numeric App Store id
+  androidPackage?: string; // Android application id / package name
+}
+```
+
+- **`requestReview(options?)`** — Shows the native in-app prompt. If the native
+  module is not linked, falls back to `openStoreReview(options)`.
+- **`openStoreReview(options)`** — Explicitly opens the store listing
+  (App Store "write review" sheet on iOS, Play Store listing on Android).
+- **`isReviewSupported()`** — `true` when the native module is linked.
+
+## Important notes
+
+The OS controls whether the prompt actually appears — you can call it, but there
+is no guarantee it shows:
+
+- **iOS**: the prompt **never** appears in debug builds or via TestFlight. Test
+  it in a production/App Store build. Apple also rate-limits it (a few times per
+  365 days per device).
+- **Android**: Play rate-limits and may show nothing (quota). Test with an
+  internal testing track / a license-tester account. The call resolves either
+  way — treat a resolved promise as "attempted", not "shown".
+
+Because the flow can silently do nothing, don't rely on a callback to know the
+user reviewed, and don't block UI on it.
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,36 @@
+apply plugin: "com.android.library"
+apply plugin: "org.jetbrains.kotlin.android"
+
+def safeExtGet(prop, fallback) {
+  rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+android {
+  namespace "com.bgoswaldo.inappstorereview"
+
+  compileSdkVersion safeExtGet("compileSdkVersion", 35)
+
+  defaultConfig {
+    minSdkVersion safeExtGet("minSdkVersion", 24)
+    targetSdkVersion safeExtGet("targetSdkVersion", 35)
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "com.google.android.play:review-ktx:2.0.2"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/com/bgoswaldo/inappstorereview/RNInAppStoreReviewModule.kt

@@ -0,0 +1,39 @@
+package com.bgoswaldo.inappstorereview
+
+import android.app.Activity
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.google.android.play.core.review.ReviewManagerFactory
+
+class RNInAppStoreReviewModule(reactContext: ReactApplicationContext) :
+  ReactContextBaseJavaModule(reactContext) {
+
+  override fun getName(): String = NAME
+
+  @ReactMethod
+  fun requestReview(promise: Promise) {
+    val activity: Activity? = currentActivity
+    if (activity == null) {
+      // No foreground activity to attach the flow to — resolve as a no-op.
+      promise.resolve(null)
+      return
+    }
+
+    val manager = ReviewManagerFactory.create(reactApplicationContext)
+    manager.requestReviewFlow().addOnCompleteListener { request ->
+      if (request.isSuccessful) {
+        manager.launchReviewFlow(activity, request.result)
+          .addOnCompleteListener { promise.resolve(null) }
+      } else {
+        // Play may throttle or fail to fetch the flow — treat as a no-op.
+        promise.resolve(null)
+      }
+    }
+  }
+
+  companion object {
+    const val NAME = "RNInAppStoreReview"
+  }
+}

package/android/src/main/java/com/bgoswaldo/inappstorereview/RNInAppStoreReviewPackage.kt

@@ -0,0 +1,16 @@
+package com.bgoswaldo.inappstorereview
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+class RNInAppStoreReviewPackage : ReactPackage {
+  override fun createNativeModules(
+    reactContext: ReactApplicationContext,
+  ): List<NativeModule> = listOf(RNInAppStoreReviewModule(reactContext))
+
+  override fun createViewManagers(
+    reactContext: ReactApplicationContext,
+  ): List<ViewManager<*, *>> = emptyList()
+}

package/ios/RNInAppStoreReview.m

@@ -0,0 +1,13 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(RNInAppStoreReview, NSObject)
+
+RCT_EXTERN_METHOD(requestReview:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
++ (BOOL)requiresMainQueueSetup
+{
+  return YES;
+}
+
+@end

package/ios/RNInAppStoreReview.swift

@@ -0,0 +1,27 @@
+import Foundation
+import React
+import StoreKit
+import UIKit
+
+@objc(RNInAppStoreReview)
+class RNInAppStoreReview: NSObject {
+  @objc static func requiresMainQueueSetup() -> Bool {
+    return true
+  }
+
+  @objc func requestReview(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    DispatchQueue.main.async {
+      if let scene = UIApplication.shared.connectedScenes.first(where: {
+        $0.activationState == .foregroundActive
+      }) as? UIWindowScene {
+        SKStoreReviewController.requestReview(in: scene)
+      } else {
+        SKStoreReviewController.requestReview()
+      }
+      resolve(nil)
+    }
+  }
+}

package/lib/commonjs/index.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isReviewSupported = isReviewSupported;
+exports.openStoreReview = openStoreReview;
+exports.requestReview = requestReview;
+var _reactNative = require("react-native");
+const nativeModule = _reactNative.NativeModules.RNInAppStoreReview;
+/**
+ * Returns `true` when the native in-app review module is linked and available.
+ * When `false`, {@link requestReview} falls back to opening the store listing.
+ */
+function isReviewSupported() {
+  return nativeModule != null;
+}
+
+/**
+ * Opens the platform store page as a fallback when the native in-app prompt is
+ * unavailable. On iOS it opens the App Store "write review" sheet; on Android it
+ * opens the Play Store listing. Requires the matching id in `options`; otherwise
+ * it resolves without doing anything.
+ */
+async function openStoreReview(options) {
+  const url = _reactNative.Platform.select({
+    ios: options.iosAppId ? `https://apps.apple.com/app/id${options.iosAppId}?action=write-review` : undefined,
+    android: options.androidPackage ? `market://details?id=${options.androidPackage}` : undefined
+  });
+  if (url == null) {
+    return;
+  }
+  try {
+    await _reactNative.Linking.openURL(url);
+  } catch {
+    // Store app not available — nothing else we can do.
+  }
+}
+
+/**
+ * Requests the native in-app review prompt (iOS `SKStoreReviewController` /
+ * Android Play In-App Review). If the native module is not linked, it falls back
+ * to opening the store listing using the ids provided in `options`.
+ *
+ * Note: both platforms decide whether the prompt actually appears and rate-limit
+ * it. On iOS the prompt never shows in debug builds or via TestFlight — only in
+ * App Store production builds.
+ */
+async function requestReview(options = {}) {
+  if (nativeModule?.requestReview != null) {
+    await nativeModule.requestReview();
+    return;
+  }
+  await openStoreReview(options);
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","nativeModule","NativeModules","RNInAppStoreReview","isReviewSupported","openStoreReview","options","url","Platform","select","ios","iosAppId","undefined","android","androidPackage","Linking","openURL","requestReview"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAMA,MAAMC,YAAY,GAChBC,0BAAa,CACbC,kBAAkB;AAepB;AACA;AACA;AACA;AACO,SAASC,iBAAiBA,CAAA,EAAY;EAC3C,OAAOH,YAAY,IAAI,IAAI;AAC7B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeI,eAAeA,CACnCC,OAA6B,EACd;EACf,MAAMC,GAAG,GAAGC,qBAAQ,CAACC,MAAM,CAAC;IAC1BC,GAAG,EAAEJ,OAAO,CAACK,QAAQ,GACjB,gCAAgCL,OAAO,CAACK,QAAQ,sBAAsB,GACtEC,SAAS;IACbC,OAAO,EAAEP,OAAO,CAACQ,cAAc,GAC3B,uBAAuBR,OAAO,CAACQ,cAAc,EAAE,GAC/CF;EACN,CAAC,CAAC;EAEF,IAAIL,GAAG,IAAI,IAAI,EAAE;IACf;EACF;EAEA,IAAI;IACF,MAAMQ,oBAAO,CAACC,OAAO,CAACT,GAAG,CAAC;EAC5B,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeU,aAAaA,CACjCX,OAA6B,GAAG,CAAC,CAAC,EACnB;EACf,IAAIL,YAAY,EAAEgB,aAAa,IAAI,IAAI,EAAE;IACvC,MAAMhB,YAAY,CAACgB,aAAa,CAAC,CAAC;IAClC;EACF;EAEA,MAAMZ,eAAe,CAACC,OAAO,CAAC;AAChC","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/module/index.js

@@ -0,0 +1,50 @@
+"use strict";
+
+import { Linking, NativeModules, Platform } from 'react-native';
+const nativeModule = NativeModules.RNInAppStoreReview;
+/**
+ * Returns `true` when the native in-app review module is linked and available.
+ * When `false`, {@link requestReview} falls back to opening the store listing.
+ */
+export function isReviewSupported() {
+  return nativeModule != null;
+}
+
+/**
+ * Opens the platform store page as a fallback when the native in-app prompt is
+ * unavailable. On iOS it opens the App Store "write review" sheet; on Android it
+ * opens the Play Store listing. Requires the matching id in `options`; otherwise
+ * it resolves without doing anything.
+ */
+export async function openStoreReview(options) {
+  const url = Platform.select({
+    ios: options.iosAppId ? `https://apps.apple.com/app/id${options.iosAppId}?action=write-review` : undefined,
+    android: options.androidPackage ? `market://details?id=${options.androidPackage}` : undefined
+  });
+  if (url == null) {
+    return;
+  }
+  try {
+    await Linking.openURL(url);
+  } catch {
+    // Store app not available — nothing else we can do.
+  }
+}
+
+/**
+ * Requests the native in-app review prompt (iOS `SKStoreReviewController` /
+ * Android Play In-App Review). If the native module is not linked, it falls back
+ * to opening the store listing using the ids provided in `options`.
+ *
+ * Note: both platforms decide whether the prompt actually appears and rate-limit
+ * it. On iOS the prompt never shows in debug builds or via TestFlight — only in
+ * App Store production builds.
+ */
+export async function requestReview(options = {}) {
+  if (nativeModule?.requestReview != null) {
+    await nativeModule.requestReview();
+    return;
+  }
+  await openStoreReview(options);
+}
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Linking","NativeModules","Platform","nativeModule","RNInAppStoreReview","isReviewSupported","openStoreReview","options","url","select","ios","iosAppId","undefined","android","androidPackage","openURL","requestReview"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,OAAO,EAAEC,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAM/D,MAAMC,YAAY,GAChBF,aAAa,CACbG,kBAAkB;AAepB;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAY;EAC3C,OAAOF,YAAY,IAAI,IAAI;AAC7B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeG,eAAeA,CACnCC,OAA6B,EACd;EACf,MAAMC,GAAG,GAAGN,QAAQ,CAACO,MAAM,CAAC;IAC1BC,GAAG,EAAEH,OAAO,CAACI,QAAQ,GACjB,gCAAgCJ,OAAO,CAACI,QAAQ,sBAAsB,GACtEC,SAAS;IACbC,OAAO,EAAEN,OAAO,CAACO,cAAc,GAC3B,uBAAuBP,OAAO,CAACO,cAAc,EAAE,GAC/CF;EACN,CAAC,CAAC;EAEF,IAAIJ,GAAG,IAAI,IAAI,EAAE;IACf;EACF;EAEA,IAAI;IACF,MAAMR,OAAO,CAACe,OAAO,CAACP,GAAG,CAAC;EAC5B,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeQ,aAAaA,CACjCT,OAA6B,GAAG,CAAC,CAAC,EACnB;EACf,IAAIJ,YAAY,EAAEa,aAAa,IAAI,IAAI,EAAE;IACvC,MAAMb,YAAY,CAACa,aAAa,CAAC,CAAC;IAClC;EACF;EAEA,MAAMV,eAAe,CAACC,OAAO,CAAC;AAChC","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,35 @@
+export interface RequestReviewOptions {
+    /**
+     * Numeric App Store app id (e.g. "1234567890"). Used only by the store
+     * fallback on iOS when the native module is unavailable.
+     */
+    iosAppId?: string;
+    /**
+     * Android application id / package name (e.g. "com.acme.app"). Used only by
+     * the store fallback on Android when the native module is unavailable.
+     */
+    androidPackage?: string;
+}
+/**
+ * Returns `true` when the native in-app review module is linked and available.
+ * When `false`, {@link requestReview} falls back to opening the store listing.
+ */
+export declare function isReviewSupported(): boolean;
+/**
+ * Opens the platform store page as a fallback when the native in-app prompt is
+ * unavailable. On iOS it opens the App Store "write review" sheet; on Android it
+ * opens the Play Store listing. Requires the matching id in `options`; otherwise
+ * it resolves without doing anything.
+ */
+export declare function openStoreReview(options: RequestReviewOptions): Promise<void>;
+/**
+ * Requests the native in-app review prompt (iOS `SKStoreReviewController` /
+ * Android Play In-App Review). If the native module is not linked, it falls back
+ * to opening the store listing using the ids provided in `options`.
+ *
+ * Note: both platforms decide whether the prompt actually appears and rate-limit
+ * it. On iOS the prompt never shows in debug builds or via TestFlight — only in
+ * App Store production builds.
+ */
+export declare function requestReview(options?: RequestReviewOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAUA,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@acertijosapps/react-native-in-app-store-review",
+  "version": "1.1.0",
+  "description": "Ask users to rate and review your React Native app in-app — native iOS (SKStoreReviewController) and Android (Play In-App Review) prompts, with an App Store / Play Store fallback.",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index.tsx",
+  "source": "src/index.tsx",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "*.podspec",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!android/build",
+    "!android/.gradle"
+  ],
+  "scripts": {
+    "prepare": "bob build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "react-native",
+    "react-native-in-app-store-review",
+    "react-native-in-app-review",
+    "react-native-store-review",
+    "ios",
+    "android",
+    "expo",
+    "review",
+    "reviews",
+    "rating",
+    "ratings",
+    "rate",
+    "rate-app",
+    "rate-us",
+    "app-review",
+    "app-rating",
+    "in-app-review",
+    "in-app-rating",
+    "store-review",
+    "app-store",
+    "appstore",
+    "play-store",
+    "google-play",
+    "storekit",
+    "SKStoreReviewController",
+    "play-core"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/acertijoslibs/rninappstorereview.git"
+  },
+  "author": "bgoswaldo <bgoswaldo@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://gitlab.com/acertijoslibs/rninappstorereview#readme",
+  "bugs": {
+    "url": "https://gitlab.com/acertijoslibs/rninappstorereview/-/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "@react-native/babel-preset": "0.86.0",
+    "@types/react": "^19.0.0",
+    "react": "19.2.3",
+    "react-native": "0.86.0",
+    "react-native-builder-bob": "^0.35.0",
+    "typescript": "^5.8.3"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/react-native-in-app-store-review.podspec

@@ -0,0 +1,19 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-in-app-store-review"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  s.platforms    = { :ios => "13.0" }
+  s.source       = { :git => "https://gitlab.com/acertijoslibs/rninappstorereview.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.frameworks   = "StoreKit"
+
+  install_modules_dependencies(s)
+end

package/src/index.tsx

@@ -0,0 +1,79 @@
+import { Linking, NativeModules, Platform } from 'react-native';
+
+interface NativeReviewModule {
+  requestReview: () => Promise<void>;
+}
+
+const nativeModule = (
+  NativeModules as { RNInAppStoreReview?: NativeReviewModule }
+).RNInAppStoreReview;
+
+export interface RequestReviewOptions {
+  /**
+   * Numeric App Store app id (e.g. "1234567890"). Used only by the store
+   * fallback on iOS when the native module is unavailable.
+   */
+  iosAppId?: string;
+  /**
+   * Android application id / package name (e.g. "com.acme.app"). Used only by
+   * the store fallback on Android when the native module is unavailable.
+   */
+  androidPackage?: string;
+}
+
+/**
+ * Returns `true` when the native in-app review module is linked and available.
+ * When `false`, {@link requestReview} falls back to opening the store listing.
+ */
+export function isReviewSupported(): boolean {
+  return nativeModule != null;
+}
+
+/**
+ * Opens the platform store page as a fallback when the native in-app prompt is
+ * unavailable. On iOS it opens the App Store "write review" sheet; on Android it
+ * opens the Play Store listing. Requires the matching id in `options`; otherwise
+ * it resolves without doing anything.
+ */
+export async function openStoreReview(
+  options: RequestReviewOptions,
+): Promise<void> {
+  const url = Platform.select({
+    ios: options.iosAppId
+      ? `https://apps.apple.com/app/id${options.iosAppId}?action=write-review`
+      : undefined,
+    android: options.androidPackage
+      ? `market://details?id=${options.androidPackage}`
+      : undefined,
+  });
+
+  if (url == null) {
+    return;
+  }
+
+  try {
+    await Linking.openURL(url);
+  } catch {
+    // Store app not available — nothing else we can do.
+  }
+}
+
+/**
+ * Requests the native in-app review prompt (iOS `SKStoreReviewController` /
+ * Android Play In-App Review). If the native module is not linked, it falls back
+ * to opening the store listing using the ids provided in `options`.
+ *
+ * Note: both platforms decide whether the prompt actually appears and rate-limit
+ * it. On iOS the prompt never shows in debug builds or via TestFlight — only in
+ * App Store production builds.
+ */
+export async function requestReview(
+  options: RequestReviewOptions = {},
+): Promise<void> {
+  if (nativeModule?.requestReview != null) {
+    await nativeModule.requestReview();
+    return;
+  }
+
+  await openStoreReview(options);
+}