A commercial-grade, 100% offline Android Point of Sale (POS), Stock Batch Inventory, Customer Khata CRM, and Billing System powered by React 19, TypeScript, Tailwind CSS v4, and Capacitor 8.
Important
SKmart POS is officially maintained by PplCallMeSk-15.
For your security, download SKmart POS only from the official sources below:
- 🌐 Official Website: https://ppl-call-me-sk.web.app
- 📦 Official GitHub Releases: https://github.com/PplCallMeSk-15/SKmart-Pos-Mobile/releases
Repositories, APKs, ZIP files, installers, or modified builds distributed by third parties are not maintained, verified, or endorsed by the SKmart POS project.
If you find another repository distributing SKmart POS, verify that downloads point back to the official sources above before running any files.
- 🌍 Official Website: https://ppl-call-me-sk.web.app
- 📦 Latest GitHub Release: https://github.com/PplCallMeSk-15/SKmart-Pos-Mobile/releases
| Mobile POS Billing & Dynamic Cart | Live Camera Barcode Scanning with MLKit/ZXing |
|---|---|
 |
 |
| Inventory Batch & Stock Intelligence | Dynamic Merchant UPI Payment Modal |
|---|---|
 |
 |
To build the ready-to-install Android APK on your computer:
# 1. Install dependencies
npm install
# 2. Check your environment diagnostics
npm run doctor
# 3. Build the Android APK in one command
npm run build:apk📍 Compiled APK Location:
android/app/build/outputs/apk/debug/app-debug.apk
Unlike traditional Android repositories that fail if gradle-wrapper.jar is missing, damaged by ZIP extraction, or if Gradle is not globally installed:
- Zero Global Gradle Requirement: You never need to install Gradle globally or configure
gradlein your systemPATH. - Zero Manual Wrapper Downloads: You do not need to download or search for binary JAR files manually.
- Deterministic Gradle 8.14.3 Bootstrapping:
npm run build:apkautomatically checks the wrapper health. If missing or damaged, it safely downloads official Gradle 8.14.3 directly fromhttps://services.gradle.orgover HTTPS into a local, git-ignored directory (.gradle-tooling/), extracts it with integrity checks, and executes the build smoothly. - Smart Java 17 Resolution: Automatically detects compatible JDK 17 installations (Eclipse Adoptium Temurin, Microsoft OpenJDK, Oracle JDK, or compatible Android Studio JBR), prioritizing Java 17 to prevent Gradle class version incompatibilities (such as Java 25 class file major version 69).
You need the following tools installed on your computer:
- Node.js 20 LTS (or newer): Download from nodejs.org
- Java JDK 17 (LTS): Eclipse Adoptium Temurin 17
- On Windows:
winget install EclipseAdoptium.Temurin.17.JDK
- On Windows:
- Android Studio (Ladybug / Koala / Hedgehog or newer): Download from developer.android.com
- During Android Studio setup, install standard Android SDK Platform (Android 14/15, API 34/35/36) and Android SDK Build-Tools.
Open Command Prompt (cmd.exe) or PowerShell in the project directory:
npm install
npm run doctor
npm run build:apknpm run build:apk automatically handles the entire pipeline:
- Compiles the modern React web application with Vite
- Synchronizes plugins and web assets into the Android native project via Capacitor 8
- Auto-configures Java from Android Studio if
JAVA_HOMEis not set - Resolves the Gradle 8.14.3 toolchain (using the wrapper or local verified distribution)
- Compiles
assembleDebugand writesandroid\app\build\outputs\apk\debug\app-debug.apk
Open Terminal in the project directory:
npm install
npm run doctor
npm run build:apknpm install
npm run build:apkBuilds the complete, production-ready app-debug.apk directly in your terminal without opening Android Studio.
npm install
npm run cap:sync
npm run cap:openOpens the native Android project in Android Studio for live emulator testing, USB device debugging, and Profiler inspection.
npm run devLaunches the live preview dev server at http://localhost:3000.
Run the built-in diagnostic tool anytime:
npm run doctorIt validates:
- Node.js version & npm readiness
- Java JDK 17 LTS (PATH, Eclipse Adoptium, Microsoft OpenJDK, or Android Studio JBR)
- Project Java 17 configuration (enforces Java 17 across all Capacitor modules)
- Android SDK location (
ANDROID_HOMEor Android Studio default) - Android native project structure
- Gradle 8.14.3 build toolchain status
| Feature | Details |
|---|---|
| Application Name | SKmart POS |
| Package ID | com.skmart.pos |
| Mobile Runtime | Capacitor 8 (Android Native) |
| Frontend Stack | React 19, TypeScript, Tailwind CSS v4 |
| Offline Database | Embedded SQLite with Local Storage fallback |
| Barcode Scanning | ML Kit Camera Scanner (Rear camera + Flash support) |
| Printing Support | 58mm & 80mm ESC/POS Thermal Receipt Printing |
| UPI Payments | Dynamic Offline Bharat QR Code Generator (upi://pay) |
| Security | 4-Digit Terminal Lock PIN with bcrypt protection |
Distributed under the MIT License. See LICENSE for more details.