App Stores Versioning

Last Updated: June 19, 2026

VineOS is distributed as a mobile web platform wrapped in high-efficiency native containers for **Android** and **iOS**. To maintain API security, feature compatibility, and database RLS alignment, we enforce strict app store version controls.

1. Wrapper Architecture & Version Handshake

The native wrappers load our secure web application dashboard inside a optimized WebView container:

Upon startup, the native client wrapper executes a handshake call to `https://app.vineos.in/api/version` passing the local build code.
The API compares the native client build version against the server-side configuration constants `min_required_android_version` and `min_required_ios_version`.
If the build falls below the allowed threshold, a blocking native system banner is triggered to enforce updates.

2. Force Update Enforcement Guidelines

To avoid app instability caused by structural database schema modifications or RPC updates, force updates are executed under the following policies:

Critical API Upgrades: Changes to authentication procedures (such as PIN hashing algorithms or WebAuthn configurations) require a 100% force update on all active wrappers.
Non-blocking Upgrades: Performance adjustments or non-breaking UI edits trigger soft alerts, encouraging users to update but allowing them to bypass the notice.

3. White-label & Custom Brand Distribution

Organizations on the **Kingdom** tier receive custom white-label wrappers with personalized app icons, splash screens, and localized Play Store distribution keys:

Custom wrappers inherit the core version handshake API scoped specifically to the tenant's app identifier (Bundle ID / Package Name).
Kingdom branch administrators configure their own redirect store links directly inside the VineOS Control Center (`/apps/admin`).

4. Play Store compliance

To guarantee complete Google Play Store and Apple App Store compliance, VineOS hosts public support documents (including Privacy Policies and Terms of Service) directly on our root domain `www.vineos.in`. All native app listings must link back to these documents to pass store review cycles.

5. Support & Developer Center

For custom compilation help, API credentials, or publishing support, contact our mobile development center:

developer@vineos.in