Astra Web Platform - WebView, JS Bridge & OAuth Toolkit – Unity Tool

Add browser-powered panels, WebGL previews, account flows, diagnostics, and automation to Unity from one source-included web platform. Astra Web Platform is built for teams that need no-code WebView setup, code-first browser APIs, a typed JavaScript bridge, OAuth/OIDC foundations, profiles, policies, downloads, diagnostics, Visual Scripting actions, samples, and demo documentation.

Online Demo | View Online Documentation

Astra is more than a simple embedded browser wrapper. It gives your project a structured web runtime layer: browser lifecycle, engine selection, secure bridge messaging, auth/token workflows, profile storage, policy gates, network transfers, support-bundle diagnostics, and automation commands.

Use the no-code component for quick setup, or drive browser sessions, profiles, policies, bridge calls, auth, diagnostics, and automation directly from C#.

💡 WHY ASTRA WEB PLATFORM

• NO-CODE WEBVIEW SETUP — add `AstraWebViewComponent`, set a URL, choose an engine, assign optional Settings/Profile assets, and press Play.

• CODE-FIRST BROWSER RUNTIME — use browser managers, engine registry, browser pools, tabs, profiles, policy gates, and diagnostics from C#.

• TYPED JAVASCRIPT BRIDGE — request/response messages, channel/type policies, structured errors, timeout/cancellation handling, diagnostics, and chunked transport.

• AUTH AND OIDC FOUNDATIONS — provider templates, OAuth/PKCE helpers, redirect validation, token vault interfaces, encrypted persistence, OIDC discovery mapping, and ID-token validation helpers.

🎁 WHAT'S INCLUDED

• Browser abstraction — Automatic, Mock, Windows WebView2, WebGL iframe, Apple WebKit, Android WebView, Linux WebKitGTK, and CEF scaffolding.

• Profiles, storage, and policy — cookies, local/session storage, IndexedDB metadata, cache entries, allowed origins, channels, payload limits, localhost behavior, downloads, and byte limits.

• Networking and diagnostics — UnityWebRequest/mock clients, transfer manager, support bundles, HAR-like traces, and redacted diagnostics exports.

• Automation and Visual Scripting — browser, tab, bridge, auth, network, cookie, storage, diagnostics, assertion, and title-check actions.

🚀 HOW IT WORKS

• 1. Add `AstraWebViewComponent` to a scene, or initialize browser services from code.
• 2. Select an engine and assign Settings/Profile assets when needed.
• 3. Navigate to URLs, load HTML, evaluate scripts, send bridge messages, or run automation commands.
• 4. Use policy settings to allow/reject origins, channels, downloads, payload sizes, and localhost behavior.
• 5. Export diagnostics/support bundles when a customer or tester reports an issue.
• 6. Host the WebGL demo so buyers can preview the workflow before purchasing.

• WebGL demo: validated with a 1920x1080 WebGL player, zero recorded page errors, and a live iframe adapter opening a real page.

• Windows WebView2: standalone player self-report opened a live page through `astra.webview2` and read ready state, title, and URL.

⚠️ WHAT'S INCLUDED VS NOT INCLUDED

Included:
• no-code WebView component
• code-first browser runtime APIs
• JavaScript bridge
• OAuth/OIDC foundations
• profiles, policies, diagnostics, downloads, automation, and samples
• WebGL and Windows WebView2 documentation

Not included:
• turnkey production support for every native platform out of the box
• hosted backend auth service
• guarantee that every platform-gated adapter fits every production project without integration work

📄 THIRD-PARTY CONTENT

Asset uses the Microsoft Edge WebView2 SDK under the BSD 3-Clause License; see Third-Party Notices.txt file in package for details. The Windows plugin Plugins/x86_64/AstraWebView2.dll is built from the included source and statically links the WebView2 loader, so Microsoft's code is present inside that binary.

Asset uses Chromium Embedded Framework (CEF) under the BSD 3-Clause License; see Third-Party Notices.txt file in package for details. No CEF binary is distributed with this package - the included CMake script links against a CEF distribution you supply yourself.

The Linux build script links WebKitGTK and GTK 3 through pkg-config, and the macOS and iOS paths link Apple's own WebKit, Foundation and AppKit frameworks. Those are system libraries supplied by the operating system, and no third-party binary for them ships here.

No third-party fonts, images, audio or icons are included.

📧 SUPPORT & QUESTIONS

For questions, bug reports, or feature requests, contact:

👉 [email protected]

Please include Unity version, target platform, selected engine, capability output, diagnostics export/support bundle, and reproduction steps.

⚙️ COMPATIBILITY

Validated in Unity 6000.0.62f1. WebGL build support is required to build the online demo. Windows WebView2 runtime is required for the Windows WebView2 adapter path. Other platform-gated adapters require their matching platform SDKs/devices.

🧩 CORE
• Package type: managed browser/runtime platform for Unity.
• No-code entry: `AstraWebViewComponent` with URL, engine selection, Settings/Profile assets, auto-open, and status overlay.
• Engine selection: `AstraBrowserEngineFactory` maps Inspector selections to built-in engine ids.
• Runtime services: browser manager, lifecycle, tabs, browser pool, profiles, policies, diagnostics, and engine registry.
• CI/editor path: deterministic mock browser engine.
• Source access: full C# source included.

🌐 BROWSER ENGINES
• Automatic: chooses the best available configured path.
• Mock: deterministic editor/test engine.
• Windows WebView2: validated by standalone player self-report.
• WebGL iframe: validated in the interactive WebGL demo.
• Scaffolded/native families: Apple WebKit, Android WebView, Linux WebKitGTK, and CEF Chromium.

🔗 BRIDGE
• Messages: typed envelopes, request/response, publish flows, structured errors, and chunked transport.
• Safety: channel/type allowlisting, payload limits, timeout/cancellation handling.
• Diagnostics: bridge events and failure data flow into support bundles.

🔐 AUTH, PROFILES & POLICY
• Auth helpers: OAuth/PKCE sessions, redirect validation, OIDC discovery mapping, ID-token validation helpers.
• Provider templates: Google, Microsoft, Discord, GitHub, and custom providers.
• Profiles: cookies, local storage, session storage, IndexedDB metadata, cache entries, and clear workflows.
• Policies: origins, bridge channels, message types, localhost, download destinations, and max-byte limits.

📡 NETWORKING, DIAGNOSTICS & AUTOMATION
• Networking: UnityWebRequest and mock request clients.
• Transfers: download/upload manager with destination-root safety and max-byte limits.
• Diagnostics: event summary APIs, editor diagnostics window, HAR-like trace previews, and redacted support bundles.
• Automation: browser create/navigate/load/evaluate, bridge requests/streams, mock auth, mock network, cookie/storage commands, diagnostics assertions, and title checks.

🧪 DEMO & DOCUMENTATION
• Interactive demo scene: `Assets/AstraWebPlatform/Demo/Scenes/AstraWebPlatform_InteractiveDemo.unity`.
• WebGL output: `Builds/AstraWebPlatform/WebGLDemo`.
• WebGL validation: build success, WebGL context, loading complete, zero page errors, and live iframe validation.
• Windows validation: `astra.webview2`, ready state complete, title and evaluated URL from a real page.

⚙️ REQUIREMENTS & COMPATIBILITY
• Unity version: validated project version 6000.0.62f1.
• Demo UI: Unity UI, desktop WebGL presentation at 1920x1080.
• WebGL: requires WebGL build support.
• Windows: WebView2 runtime required for Windows WebView2 adapter.
• Boundaries: platform-gated adapters require the matching target SDKs and project integration work.