🧩 HBH-WEB2APP — Convert Any Website / HTML Folder Into Android APK

HBH-WEB2APP is a Node.js-based Android APK generator that converts any website, local folder, or zip archive into a full Android application — automatically.

✔ No Android Studio ✔ No Gradle knowledge ✔ Runs on Windows, macOS, Linux ✔ Full offline build system ✔ Auto-installs Java + Android SDK ✔ Custom App Name, Package Name, Icons

---

🚀 Features

• 🧱 Generate APK from URL, HTML folder, or ZIP
• 🎨 Auto-generate adaptive Android icons (sharp)
• 🏗 Full Gradle Build System
• 🛠 Automatic Android SDK + Java 17 installer
• 🗂 Full asset pipeline
• 🔄 Template-based build workflow
• 📦 Batch build support
• ⏱ Execution time tracker
• 🧹 Safe template extraction system

---

📦 Installation

          
            1npm install hbh-web2app
          
        

Or globally:

          
            1npm install -g hbh-web2app
          
        

---

🛠 Setup Android Build Environment

Before building an APK, run:

✔ Check SDK & Java

          
            1npm run check-sdk
          
        

or

✔ Check SDK & Java (manually)

          
            1const { CheckSDK } = require("hbh-web2app");3async function verifySDK() {4  const result = await CheckSDK();5  console.log(result);6}8verifySDK();
          
        

This function will check if your system already has the required:

• OpenJDK 17
• Android SDK command-line tools
• Platform-tools and Build-tools
• Required Android platform

---

✔ Install Android SDK + Java (portable — inside your project)

          
            1npm run install-sdk
          
        

or

✔ Install Android SDK + Java manually

          
            1const { InstallSDK } = require("hbh-web2app");3async function setupSDK() {4  await InstallSDK(/*SDK_PATH: optional*/);5  console.log("SDK + Java installed locally!");6}8setupSDK();
          
        

This installs:

• OpenJDK 17
• Android command-line tools
• Platform-tools
• Build-tools 34.0.0
• Android platform 34

It also automatically sets required environment variables.

---

🧪 Example Usage

          
            1const { GenerateApp } = require("hbh-web2app");3GenerateApp({4  appName: "HBHGoogle",5  packageName: "hbh.sites.google",6  asset: "https://www.google.com/", // URL OR Folder OR Zip7  appIcon: "https://www.google.com/favicon.ico" // URL OR local_path8});
          
        

---

          
            1GenerateApp({2  appName: "LocalSite",3  packageName: "com.local.site",4  asset: "./my-website-folder"5});
          
        

---

          
            1GenerateApp({2  appName: "ZippedWebsite",3  packageName: "com.zip.site",4  asset: "./site.zip"5});
          
        

---

          
            1const { GenerateApps } = require("hbh-web2app");3GenerateApps([4  {5    appName: "AppOne",6    packageName: "com.app.one",7    asset: "https://google.com"8  },9  {10    appName: "AppTwo",11    packageName: "com.app.two",12    asset: "./localfolder"13  }14]);
          
        

---

📁 Output

APK files are generated here:

/output/<AppName>/<AppName>.apk

Example:

output/MyWebApp/MyWebApp.apk

---

🧬 Project Structure (Internal Overview)

app/
 ├─ builder.js          # Main build system
 ├─ helpers/            # logger, unzip, icon generator, etc.
 ├─ tasks/              # assets, build, applyConfig, etc.
 ├─ utils/              # TrackTimeWrapper
 ├─ setupWorkflow.js    # safe extraction + cleanup
 ├─ config.js
checking.js             # SDK checker
installer.js            # SDK & Java installer
index.js                # Main exports

---

⚙ API – Configuration Options

---

🎨 Icons

App icons are auto-generated into:

mipmap-mdpi
mipmap-hdpi
mipmap-xhdpi
mipmap-xxhdpi
mipmap-xxxhdpi

Each converted to:

ic_launcher_foreground.webp

---

🔧 Built-In Commands

---

🧑‍💻 Requirements

• Node.js >= 16
• Windows / macOS / Linux
• 4GB free space for SDK install
• Internet (if using URL or installer)

---

💬 Author

HBH Creator of HBH-WEB2APP

---

📄 License

ISC License