From a1a35ee15e931dcb88715b85e4b35ebf0492381d Mon Sep 17 00:00:00 2001
From: yungsamd17 <64147848 + yungsamd17@users.noreply.github.com>
Date: Sun, 23 Aug 2026 17:14:49 +0000
Subject: [PATCH] Add GitHub Actions CI to build debug APK

- Build assembleDebug on push/PR with JDK 17 + Android SDK
- Gradle wrapper validation and dependency caching
- Upload app-debug.apk as workflow artifact
- CI status badge in README
---
 .github/workflows/ci.yml | 47 ++++++++++++++++++++++++++++++++++++++++
 CHANGELOG.md             |  8 +++++++
 README.md                |  2 ++
 3 files changed, 57 insertions(+)
 create mode 100644 .github/workflows/ci.yml

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..d75ac09
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build debug APK
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Validate Gradle wrapper
+        uses: gradle/actions/wrapper-validation@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+
+      - name: Set up Android SDK
+        uses: android-actions/setup-android@v3
+
+      - name: Set up Gradle caching
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Build debug APK
+        run: ./gradlew assembleDebug --stacktrace
+
+      - name: Upload APK artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: app-debug-apk
+          path: app/build/outputs/apk/debug/app-debug.apk
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8375441..7733c37 100755
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,14 @@ All notable changes to WebShell will be documented here.
 
 ---
 
+## [Unreleased]
+
+### Added
+- GitHub Actions CI (`.github/workflows/ci.yml`): builds a debug APK on every push/PR, validates the Gradle wrapper, caches Gradle, uploads the APK as an artifact
+- CI status badge in README
+
+---
+
 ## [1.0.2] — Portability & Hygiene Fixes
 
 ### Fixed
diff --git a/README.md b/README.md
index f6c79cb..b04cb07 100755
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # 🐚 WebShell
 
+[![CI](https://github.com/s17labs/webshell/actions/workflows/ci.yml/badge.svg)](https://github.com/s17labs/webshell/actions/workflows/ci.yml)
+
 **A minimal Android WebView wrapper kit for building native Android apps with plain HTML, CSS, and JavaScript.**
 
 No React. No Electron. No Capacitor. No bloat. Just a clean, well-documented Android shell that loads your web app and gives it access to native device features through a simple JS bridge.