Official Release Edition

WebToApp Studio Pro Documentation

The complete user and developer guide for converting any live website URL or local static HTML5 project into high-performance standalone Windows desktop executables.

1. Overview & Architecture

WebToApp Studio Pro is a commercial developer utility software created for entrepreneurs, web agencies, game creators, and indie developers who want to distribute their web applications as native Windows desktop software without recurring fees or complex build tooling.

Why WebToApp Studio Pro outperforms traditional solutions:

No Electron Bloat: Electron apps weigh 150MB+ and consume 400MB+ of RAM. WebToApp Studio Pro apps use Microsoft Edge WebView2, producing lean 14MB executables that load in milliseconds.
Zero SDK Required for Buyers: Unlike command-line CLI builders, WebToApp Studio Pro features an Instant Template Engine. Buyers click "Build" and get an executable in seconds without installing C++ compilers or Node.js.
HTTPS Virtual Host (`https://app.local/`): Eliminates `file://` protocol CORS bugs. WebGL, Web Audio, LocalStorage, IndexedDB, and ES6 modules work seamlessly.

2. System Requirements

For the WebToApp Studio Builder:

Operating System: Windows 10 (1809+) or Windows 11 (64-bit).
Runtime: .NET 8.0 Desktop Runtime (pre-installed or auto-installed).
Display: 1280 × 720 minimum screen resolution.

For Generated Executables:

Windows 10 / 11 (64-bit).
Microsoft Edge WebView2 Runtime (standard on all modern Windows installations).

3. Quick Start (Build in 30 Seconds)

Launch WebToApp-Studio.exe.
Under 1. Source, choose Website URL (enter your website) or Local HTML5 Folder (pick your folder containing index.html).
Under 2. Branding, enter your Application Name (e.g. My Awesome App) and select an icon.
Under 3. Window, choose a preset (e.g. 1280 × 800).
Click the primary button: BUILD EXECUTABLE.
Once the progress bar hits 100%, click Test Run App to verify your newly generated desktop application!

4. Converting a Live Website (URL Mode)

URL Mode transforms any online SaaS platform, e-commerce store, or web portal into a focused desktop app.

Network Auto-Reconnect

When URL mode is selected with "Offline Connection Error Page" enabled, if the user loses Wi-Fi, the app automatically transitions to a stylish dark reconnect view and resumes when network connectivity is restored.

External Link Routing: When "Open External Links in Default Browser" is enabled, any links directing to other domains or opened with target="_blank" will launch in the user's default browser (e.g. Google Chrome), keeping your application window dedicated to your main site.

5. Converting Static HTML/CSS/JS (Offline Mode)

Offline Mode embeds your static website folder directly inside the desktop application package.

Ensure an entrypoint file exists in your folder (typically index.html).
Assets are served via the internal secure origin https://app.local/.
All relative paths (e.g. <script src="js/app.js">, <img src="img/logo.png">) work out of the box.
Local storage and IndexedDB remain persistent between app restarts.

6. Packaging HTML5 Games & Web Audio

WebToApp Studio Pro is optimized for HTML5 game engines:

Construct 3 & Phaser: Export as "HTML5 Website / Web", choose the export folder in WebToApp Studio Pro, and compile.
WebGL & Canvas: Full GPU hardware acceleration is enabled by default.
Web Audio API: Low-latency spatial audio and background music run without browser autoplay restrictions.

7. Custom Icons & Executable Branding

You can upload either a .ico file or a standard .png image. WebToApp Studio Pro's built-in image processor will automatically generate multi-resolution icon layers (16x16, 32x32, 48x48, 64x64, 128x128, and 256x256) to ensure your app icon is razor sharp on both the Windows taskbar and desktop shortcuts.

8. Splash Screens & Offline Fallbacks

Custom Splash Screen: When enabled, a borderless window displays your logo immediately upon launch. As soon as the underlying web engine finishes rendering the DOM, the splash screen performs a smooth alpha fade-out transition.

9. DevTools & Code Protection

For commercial releases, you generally do not want end-users viewing your proprietary JavaScript code or modifying DOM variables:

Disable Developer Tools (F12): Suppresses F12, Ctrl+Shift+I, and inspect tools.
Disable Right-Click Context Menu: Removes the default browser context menu.
Disable Text Selection: Gives the application a genuine native software appearance.
Single Instance Mutex: Prevents opening multiple copies, avoiding state collisions and excessive memory consumption.

10. System Tray & Kiosk Mode

System Tray Integration: Displays a tray icon with "Open [AppName]" and "Exit". If "Minimize to Tray on Close" is activated, closing the window will silently dock the application to the tray.

Kiosk / Fullscreen Mode: Ideal for interactive museum exhibits, digital signage, or point-of-sale displays. The window opens borderless across the entire display.

11. 1-Click In-App Auto-Updater

WebToApp Studio Pro features a built-in automated software update engine that allows buyers to upgrade to new releases without manual downloads or re-extracting zip files.

How It Works for Buyers:

On startup (or by clicking Check Updates in the header), the Studio checks the remote manifest.
If a newer version exists, a glowing green notification appears: Update vX.X Available!.
Clicking the notification opens the Release Notes Modal detailing the changelog.
Clicking 1-Click Update & Restart downloads the release package, automatically extracts the new binaries over the existing folder, and restarts the application in ~2 seconds.

12. Dual Export & Google Play Store Publishing

WebToApp Studio Pro includes a built-in cross-platform compilation engine that outputs both standalone Windows Desktop executables and production-ready Android Studio projects / Google Play App Bundles (.aab).

🚀 The Turnkey Zero-SDK Workflow

In the top bar of WebToApp Studio, select your target export platform:
- Windows (.exe): Builds standalone Windows 10/11 desktop executable.
- Android App: Generates Android 14 (API 34) Gradle project, launcher mipmaps, and APK/AAB bundle.
- ⚡ Dual Build (Both): Compiles both Windows and Android packages in a single click!
Open Tab 6: Android & Play Store to customize:
- Package Name: Reverse-domain identifier (e.g., com.mycompany.myapp). Use the "Auto-generate" button for instant formatting.
- Version Code: Google Play incrementing build number (e.g. 1, 2, 3).
- Orientation: Choose Portrait, Landscape, or Sensor auto-rotation.
- WebViewAssetLoader: Automatically serves local static files over https://appassets.androidplatform.net/, ensuring modern Web Audio, Canvas, and localStorage work flawlessly without CORS blocks.
- Pull to Refresh: Native Android SwipeRefreshLayout gesture.
Click BUILD EXECUTABLE / DUAL BUILD.

📦 Opening & Publishing Your Android App

WebToApp Studio Pro produces a turnkey project ZIP: [AppName]_Android_Studio_Project.zip containing:

Complete Gradle build scripts (build.gradle.kts, settings.gradle.kts) configured for Android 14 (API 34).
Optimized launcher icons across all 5 mipmap densities (mdpi, hdpi, xhdpi, xxhdpi, xxxhdpi).
GOOGLE_PLAY_PUBLISH_GUIDE.txt with step-by-step instructions for uploading to the Google Play Console.
If Java JDK / Android SDK is installed on your computer, WebToApp Studio Pro compiles the .aab and .apk binaries automatically!

13. Ubuntu Linux & Debian Packaging (.deb)

WebToApp Studio Pro features a native pure C# Debian packaging engine that compiles genuine binary .deb packages directly on Windows with zero external toolchains, WSL, or Docker required.

🐧 How to Export for Ubuntu & Debian:

In the top target selector bar, click Ubuntu Linux (.deb) or switch to tab 7. Linux & Ubuntu.
Configure your Debian package properties:
- Debian Package Name: Lowercase package identifier (e.g. com.wildcatstudio.myapp or myapp).
- Target Architecture: Choose all (universal compatibility across x86_64, arm64, and Raspberry Pi) or specific target architectures (amd64, arm64).
- Debian Section & Categories: Choose standard Debian sections (utils, web, games, graphics, net) and desktop categories for GNOME / Ubuntu Dash.
- Dependencies: Pre-configured with automatic fallbacks: python3, python3-gi, gir1.2-webkit2-4.1 | gir1.2-webkit2-4.0 | chromium-browser | google-chrome-stable.
Click BUILD UBUNTU APP (.DEB).

📦 Output Deliverables

WebToApp Studio Pro generates two complete distribution packages inside your output folder:

[app]_[version]_[arch].deb: Standard binary Debian package. Users double-click to install via Ubuntu Software Center, or run:
```
sudo dpkg -i myapp_1.0.0_all.deb
sudo apt-get install -f   # Resolves any missing runtime dependencies
```
[app]_[version]_linux_portable.tar.gz: Standalone portable AppDir. Does not require root/sudo access:
```
tar -xzf myapp_1.0.0_linux_portable.tar.gz
cd myapp/
./run.sh
```
Embedded Localhost Web Server: Local HTML5 games and web apps are automatically served via an embedded background Python 3 HTTP server on localhost with an ephemeral random port, guaranteeing 100% CORS-free execution, WebGL support, and IndexedDB/localStorage storage.

14. Multi-Build (All Platforms in 1-Click)

Ship everywhere simultaneously with the Multi-Build target.

Selecting Multi-Build allows you to click one button and generate:

Windows (.exe): Standalone lightweight WebView2 desktop application.
Android (.zip): 100% turnkey Android Studio project + Google Play publishing assets (or compiled APK/AAB).
Ubuntu Linux (.deb): Debian installer package and portable Linux AppDir tarball.

Perfect for indie developers, game studios, and SaaS founders who want cross-platform distribution without maintaining three different build pipelines.

15. Frequently Asked Questions (FAQ)

Q: Do my buyers need to install Python or Node.js to use the generated app?

No! The Windows output executable is completely standalone and runs directly on Windows 10 and Windows 11. The Ubuntu Linux package includes standard system dependencies installed automatically via apt.

Q: Can I compile Ubuntu .deb packages directly on a Windows PC?

Yes! WebToApp Studio Pro contains a custom pure C# Unix ar archive writer and gzip tarball generator built on .NET 8 BCL. It generates 100% compliant Debian binary packages directly on Windows without WSL or Docker.

Q: Can I sell the applications I build with WebToApp Studio Pro?

Yes! Any applications you compile are 100% yours to sell, distribute, or license to clients royalty-free.

Q: Does WebToApp Studio Pro support cookies and local storage?

Yes. User sessions, local storage, cookies, and cache are preserved across restarts in an isolated sandboxed profile.

16. Troubleshooting & Support

Problem: "Missing WebView2 Runtime" alert on an older PC

Solution: Microsoft Edge WebView2 is built into Windows 11 and recent Windows 10 updates. If testing on an older Windows 10 build, download the free evergreen runtime installer from Microsoft's official site: https://developer.microsoft.com/microsoft-edge/webview2/.

❤️ Support the Developer (Wildcat Studio)

WebToApp Studio Pro is actively maintained by Wildcat Studio. If this utility saves you time and accelerates your releases, consider buying me a coffee or starring the repository!

☕ Buy Me a Coffee ⭐ Star on GitHub