Initial public release: v0.2.0

- Modern Play App Update SDK 2.x on Android (IMMEDIATE flow)
- Pure-JS iOS modal with iOS / Liquid Glass aesthetic
- Server-driven version thresholds (min + latest)
- TypeScript-first, React hooks API, themeable via accent prop
- SuggestUpdateBanner: dismiss × button + swipe-to-dismiss gesture
- 33 Jest tests, strict TypeScript, ESM + CommonJS dual build

Author: himanshu-zethic

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Lint, typecheck, test, build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Typecheck
+        run: yarn typecheck
+
+      - name: Run tests
+        run: yarn test --ci
+
+      - name: Build
+        run: yarn build
+
+      - name: Verify tarball contents
+        run: npm pack --dry-run

.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Typecheck
+        run: yarn typecheck
+
+      - name: Run tests
+        run: yarn test --ci
+
+      - name: Build
+        run: yarn build
+
+      - name: Publish to npm
+        run: npm publish --access public --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,38 @@
+node_modules/
+lib/
+coverage/
+
+# macOS
+.DS_Store
+
+# IDEs
+.idea/
+.vscode/
+*.iml
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Android
+android/.gradle/
+android/build/
+android/local.properties
+android/*.keystore
+
+# iOS
+ios/build/
+ios/Pods/
+ios/Podfile.lock
+
+# Example
+example/ios/Pods/
+example/android/.gradle/
+example/android/build/
+example/node_modules/
+
+# Env
+.env
+.env.local

.npmignore

@@ -0,0 +1,20 @@
+# Everything that should NOT ship in the npm tarball.
+# `files` in package.json is the allowlist; this is a belt-and-braces denylist.
+
+__tests__/
+example/
+docs/
+coverage/
+.github/
+.gitignore
+.eslintrc*
+.prettierrc*
+jest.config.js
+babel.config.js
+tsconfig.json
+tsconfig.build.json
+*.log
+.DS_Store
+
+# Source maps — not useful to consumers
+**/*.map

CHANGELOG.md

@@ -0,0 +1,74 @@
+# Changelog
+
+All notable changes to `react-native-update-gate` will be 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).
+
+## [Unreleased]
+
+## [0.2.0] — 2026-05-18
+
+### Added
+- **`accent` shorthand prop** on `<ForceUpdateModal>` and `<SuggestUpdateBanner>`.
+  Override just the primary colour without spreading a full theme object:
+  ```tsx
+  <ForceUpdateModal visible={true} accent="#0F62FE" />
+  ```
+- **`theme` prop now accepts `Partial<UpdateGateTheme>`** — pass only the
+  properties you want to override. Merged on top of the context theme + platform default.
+- **`createTheme(overrides)` helper** exported for building a complete theme
+  from partial overrides.
+- **`withAlpha(color, alpha)` helper** exported for tinted colour utilities.
+- **Built-in default icons** for both components:
+  - `ForceUpdateModal` ships a 72×72 download-arrow card (`↓`) in tinted accent.
+  - `SuggestUpdateBanner` ships a 32×32 up-arrow chip (`↑`) in tinted accent.
+  - Replace either via the new `icon` prop with any ReactNode (SVG, Lottie, Image).
+- **Subtle icon bob animation** on the default modal icon (3 px, 1.6 s loop).
+- **Optional `@react-native-community/blur` integration** — installs as an
+  optional peer dependency. When installed, the modal uses a true frosted-glass
+  backdrop on iOS. Falls back gracefully to a darker scrim when not installed.
+
+### Changed
+- Modal redesigned in iOS / Liquid Glass aesthetic: pill button, tinted accent
+  bar above title, soft floating shadow, tinted version-label pill.
+- Banner redesigned with a left accent bar, tinted icon chip, pill action button,
+  larger close-button hit target.
+- Default `radius` bumped from 20 → 24 for softer card corners.
+- Default backdrop opacity slightly reduced for a cleaner look.
+
+### Fixed
+- `useTheme` now correctly merges partial themes from context + props + accent
+  shorthand (was previously all-or-nothing).
+
+## [0.1.1] — 2026-05-15
+
+### Fixed
+- `<SuggestUpdateBanner>` now handles dismissal internally. Tapping the `×` close
+  button, tapping the action button, or `autoHideAfter` elapsing all hide the
+  banner immediately without requiring the consumer to wire `onDismiss` or
+  track local state. The banner re-appears automatically when the `visible`
+  prop transitions from `false` back to `true` (e.g. a new release bumps the
+  `latestAvailable` threshold).
+
+### Changed
+- `onDismiss` is now an **optional** callback fired *after* dismissal completes
+  (for analytics / persistence). Existing consumers that passed it continue to
+  work unchanged.
+
+## [0.1.0] — 2026-05-15
+
+### Added
+- `evaluateUpdate(input)` — pure verdict function (`'force' | 'suggest' | 'none'`).
+- `presentUpdate(mode)` — platform-aware UI trigger.
+- `configureUpdateGate(config)` — one-time package config.
+- `useUpdate(input)` — React hook with `AppState` resume re-check.
+- `<ForceUpdateModal>` — animated, themeable, accessible blocking modal for iOS (and Android fallback).
+- `<SuggestUpdateBanner>` — dismissible banner for non-critical updates.
+- `<UpdateGateThemeProvider>` + `useTheme()` — theming primitives.
+- Android native module wrapping Google's Play App Update SDK 2.x (IMMEDIATE flow).
+- iOS: zero native code — pure-RN modal + `Linking` deep-link to App Store.
+- Server-driven version threshold support (`minRequired` + `latestAvailable`).
+- TypeScript types shipped (`strict`, `noUncheckedIndexedAccess`).
+- ESM + CommonJS dual build via `react-native-builder-bob`.
+- Jest test suite covering verdict matrix, config, and hook.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SABA Hospitality
+
+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.