diff --git a/.gitignore b/.gitignore
index 88edbf9f..901d5221 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,10 +5,10 @@ node_modules/
.vscode
# Built files
-dist
-dist-renderer-webpack
-dist-library-files
-dist-extensions
+/dist
+/dist-renderer-webpack
+/dist-library-files
+/dist-extensions
src-renderer/packager/standalone.html
# Debian release scripts create files that shouldn't be committed
diff --git a/android/.gitignore b/android/.gitignore
new file mode 100644
index 00000000..aa724b77
--- /dev/null
+++ b/android/.gitignore
@@ -0,0 +1,15 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
diff --git a/android/app/.gitignore b/android/app/.gitignore
new file mode 100644
index 00000000..42afabfd
--- /dev/null
+++ b/android/app/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/android/app/build.gradle.kts b/android/app/build.gradle.kts
new file mode 100644
index 00000000..3ee131ae
--- /dev/null
+++ b/android/app/build.gradle.kts
@@ -0,0 +1,68 @@
+plugins {
+ alias(libs.plugins.android.application)
+ alias(libs.plugins.kotlin.android)
+ alias(libs.plugins.kotlin.compose)
+}
+
+android {
+ namespace = "org.turbowarp.android"
+ compileSdk {
+ version = release(36)
+ }
+
+ defaultConfig {
+ applicationId = "org.turbowarp.android"
+ minSdk = 24
+ targetSdk = 36
+ versionCode = 1
+ versionName = "1.0"
+
+ testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+ }
+
+ buildTypes {
+ release {
+ isMinifyEnabled = false
+ proguardFiles(
+ getDefaultProguardFile("proguard-android-optimize.txt"),
+ "proguard-rules.pro"
+ )
+ }
+ }
+ compileOptions {
+ sourceCompatibility = JavaVersion.VERSION_11
+ targetCompatibility = JavaVersion.VERSION_11
+ }
+ kotlinOptions {
+ jvmTarget = "11"
+ }
+ buildFeatures {
+ compose = true
+ buildConfig = true
+ }
+}
+
+dependencies {
+ implementation(libs.androidx.core.ktx)
+ implementation(libs.androidx.lifecycle.runtime.ktx)
+ implementation(libs.androidx.activity.compose)
+ implementation(platform(libs.androidx.compose.bom))
+ implementation(libs.androidx.compose.ui)
+ implementation(libs.androidx.compose.ui.graphics)
+ implementation(libs.androidx.compose.ui.tooling.preview)
+ implementation(libs.androidx.compose.material3)
+ implementation(libs.androidx.appcompat)
+ implementation(libs.material)
+ implementation(libs.androidx.activity)
+ implementation(libs.androidx.constraintlayout)
+ implementation(libs.androidx.webkit)
+ implementation(libs.brotlidec)
+ implementation(libs.androidx.navigation.compose)
+ testImplementation(libs.junit)
+ androidTestImplementation(libs.androidx.junit)
+ androidTestImplementation(libs.androidx.espresso.core)
+ androidTestImplementation(platform(libs.androidx.compose.bom))
+ androidTestImplementation(libs.androidx.compose.ui.test.junit4)
+ debugImplementation(libs.androidx.compose.ui.tooling)
+ debugImplementation(libs.androidx.compose.ui.test.manifest)
+}
\ No newline at end of file
diff --git a/android/app/proguard-rules.pro b/android/app/proguard-rules.pro
new file mode 100644
index 00000000..481bb434
--- /dev/null
+++ b/android/app/proguard-rules.pro
@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
\ No newline at end of file
diff --git a/android/app/src/androidTest/java/org/turbowarp/android/ExampleInstrumentedTest.kt b/android/app/src/androidTest/java/org/turbowarp/android/ExampleInstrumentedTest.kt
new file mode 100644
index 00000000..9ae823a8
--- /dev/null
+++ b/android/app/src/androidTest/java/org/turbowarp/android/ExampleInstrumentedTest.kt
@@ -0,0 +1,24 @@
+package org.turbowarp.android
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.ext.junit.runners.AndroidJUnit4
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.junit.Assert.*
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+ @Test
+ fun useAppContext() {
+ // Context of the app under test.
+ val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+ assertEquals("org.turbowarp.android", appContext.packageName)
+ }
+}
\ No newline at end of file
diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
new file mode 100644
index 00000000..7cb82ef4
--- /dev/null
+++ b/android/app/src/main/AndroidManifest.xml
@@ -0,0 +1,27 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/android/app/src/main/assets/dist-extensions b/android/app/src/main/assets/dist-extensions
new file mode 120000
index 00000000..40ec5ca3
--- /dev/null
+++ b/android/app/src/main/assets/dist-extensions
@@ -0,0 +1 @@
+../../../../../dist-extensions/
\ No newline at end of file
diff --git a/android/app/src/main/assets/dist-library-files b/android/app/src/main/assets/dist-library-files
new file mode 120000
index 00000000..aebd9165
--- /dev/null
+++ b/android/app/src/main/assets/dist-library-files
@@ -0,0 +1 @@
+../../../../../dist-library-files/
\ No newline at end of file
diff --git a/android/app/src/main/assets/dist-renderer-webpack b/android/app/src/main/assets/dist-renderer-webpack
new file mode 120000
index 00000000..dd46b530
--- /dev/null
+++ b/android/app/src/main/assets/dist-renderer-webpack
@@ -0,0 +1 @@
+../../../../../dist-renderer-webpack/
\ No newline at end of file
diff --git a/android/app/src/main/assets/l10n b/android/app/src/main/assets/l10n
new file mode 120000
index 00000000..ea249202
--- /dev/null
+++ b/android/app/src/main/assets/l10n
@@ -0,0 +1 @@
+../../../../../src-main/l10n/
\ No newline at end of file
diff --git a/android/app/src/main/assets/preload/editor.js b/android/app/src/main/assets/preload/editor.js
new file mode 100644
index 00000000..07d4c3de
--- /dev/null
+++ b/android/app/src/main/assets/preload/editor.js
@@ -0,0 +1,87 @@
+const {contextBridge, ipcRenderer} = require('electron');
+
+contextBridge.exposeInMainWorld('EditorPreload', {
+ isInitiallyFullscreen: () => ipcRenderer.sendSync('is-initially-fullscreen'),
+ getInitialFile: async () => null,
+ getFile: (id) => ipcRenderer.invoke('get-file', id),
+ openedFile: (id) => ipcRenderer.invoke('opened-file', id),
+ closedFile: () => ipcRenderer.invoke('closed-file'),
+ showSaveFilePicker: (suggestedName) => ipcRenderer.invoke('show-save-file-picker', suggestedName),
+ showOpenFilePicker: () => ipcRenderer.invoke('show-open-file-picker'),
+ setLocale: (locale) => ipcRenderer.sendSync('set-locale', locale),
+ setChanged: (changed) => {},
+ // openNewWindow: () => ipcRenderer.invoke('open-new-window'),
+ openAddonSettings: (search) => ipcRenderer.sendSync('open-addon-settings', search),
+ //openPackager: () => ipcRenderer.invoke('open-packager'),
+ //openDesktopSettings: () => ipcRenderer.invoke('open-desktop-settings'),
+ openPrivacy: () => ipcRenderer.sendSync('open-privacy'),
+ openAbout: () => ipcRenderer.sendSync('open-about'),
+ //getPreferredMediaDevices: () => ipcRenderer.invoke('get-preferred-media-devices'),
+ getAdvancedCustomizations: async () => ({}),
+ setExportForPackager: (callback) => {},
+ setIsFullScreen: (isFullScreen) => {}
+});
+
+//let exportForPackager = () => Promise.reject(new Error('exportForPackager missing'));
+
+//ipcRenderer.on('export-project-to-port', (e) => {
+// const port = e.ports[0];
+// exportForPackager()
+// .then(({data, name}) => {
+// port.postMessage({ data, name });
+// })
+// .catch((error) => {
+// console.error(error);
+// port.postMessage({ error: true });
+// });
+//});
+
+//window.addEventListener('message', (e) => {
+// if (e.source === window) {
+// const data = e.data;
+// if (data && typeof data.ipcStartWriteStream === 'string') {
+// ipcRenderer.postMessage('start-write-stream', data.ipcStartWriteStream, e.ports);
+// }
+// }
+//});
+
+//ipcRenderer.on('enumerate-media-devices', (e) => {
+// navigator.mediaDevices.enumerateDevices()
+// .then((devices) => {
+// e.sender.send('enumerated-media-devices', {
+// devices: devices.map((device) => ({
+// deviceId: device.deviceId,
+// kind: device.kind,
+// label: device.label
+// }))
+// });
+// })
+// .catch((error) => {
+// console.error(error);
+// e.sender.send('enumerated-media-devices', {
+// error: `${error}`
+// });
+// });
+//});
+
+//contextBridge.exposeInMainWorld('PromptsPreload', {
+// alert: (message) => ipcRenderer.sendSync('alert', message),
+// confirm: (message) => ipcRenderer.sendSync('confirm', message),
+//});
+
+// In some Linux environments, people may try to drag & drop files that we don't have access to.
+// Remove when https://github.com/electron/electron/issues/30650 is fixed.
+//if (navigator.userAgent.includes('Linux')) {
+// document.addEventListener('drop', (e) => {
+// if (e.isTrusted) {
+// for (const file of e.dataTransfer.files) {
+// // Using webUtils is safe as we don't have a legacy build for Linux
+// const {webUtils} = require('electron');
+// const path = webUtils.getPathForFile(file);
+// ipcRenderer.invoke('check-drag-and-drop-path', path);
+// }
+// }
+// }, {
+// capture: true
+// });
+//}
diff --git a/android/app/src/main/assets/preload/ipc-init.js b/android/app/src/main/assets/preload/ipc-init.js
new file mode 100644
index 00000000..e69d0929
--- /dev/null
+++ b/android/app/src/main/assets/preload/ipc-init.js
@@ -0,0 +1,63 @@
+const require = (function() {
+ let globalIpcCounter = 0;
+ const ipcInFlight = {};
+
+ AndroidIpcAsync.onmessage = (e) => {
+ const data = e.data;
+ const ipcObject = ipcInFlight[data.messageId];
+ if (!ipcObject) {
+ throw new Error(`Received async IPC with unknown ID ${data.messageId}`);
+ }
+
+ if (data.success) {
+ ipcObject.resolve(data.result);
+ } else {
+ ipcObject.reject(data.result);
+ }
+
+ delete ipcObject[data.messageId];
+ };
+
+ const contextBridge = {
+ exposeInMainWorld: (objectName, objectImplementation) => {
+ window[objectName] = objectImplementation;
+ }
+ };
+
+ const ipcRenderer = {
+ sendSync: (method, ...args) => {
+ const response = AndroidIpcSync.sendSync(JSON.stringify({
+ method,
+ args
+ }));
+ return JSON.parse(response);
+ },
+
+ invoke: (method, ...args) => new Promise((resolve, reject) => {
+ const messageId = globalIpcCounter++;
+ ipcInFlight[messageId] = {
+ resolve,
+ reject
+ };
+
+ console.log('Sending', method, args);
+
+ AndroidIpcAsync.postMessage({
+ messageId,
+ method,
+ arguments: args
+ });
+ }),
+ };
+
+ return (moduleName) => {
+ if (moduleName === "electron") {
+ return {
+ contextBridge,
+ ipcRenderer
+ };
+ }
+
+ throw new Error(`Mock require() found unknown module: ${moduleName}`);
+ };
+}());
diff --git a/android/app/src/main/ic_launcher-playstore.png b/android/app/src/main/ic_launcher-playstore.png
new file mode 100644
index 00000000..f64a7793
Binary files /dev/null and b/android/app/src/main/ic_launcher-playstore.png differ
diff --git a/android/app/src/main/java/org/turbowarp/android/AboutView.kt b/android/app/src/main/java/org/turbowarp/android/AboutView.kt
new file mode 100644
index 00000000..68eb5156
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/AboutView.kt
@@ -0,0 +1,40 @@
+package org.turbowarp.android
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.text.style.TextAlign
+import androidx.compose.ui.unit.sp
+
+@Composable
+fun AboutView() {
+ Surface(
+ modifier = Modifier.fillMaxSize(),
+ color = Color(0xffff4c4c)
+ ) {
+ Column (
+ modifier = Modifier.fillMaxSize(),
+ horizontalAlignment = Alignment.CenterHorizontally,
+ verticalArrangement = Arrangement.Center
+ ) {
+ Text(
+ text = "TurboWarp for Android",
+ fontSize = 30.sp,
+ color = Color.White,
+ textAlign = TextAlign.Center
+ )
+ Text(
+ text = "${BuildConfig.APPLICATION_ID}/${BuildConfig.VERSION_NAME}",
+ fontSize = 20.sp,
+ color = Color.White,
+ textAlign = TextAlign.Center
+ )
+ }
+ }
+}
diff --git a/android/app/src/main/java/org/turbowarp/android/AddonsView.kt b/android/app/src/main/java/org/turbowarp/android/AddonsView.kt
new file mode 100644
index 00000000..7b0be645
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/AddonsView.kt
@@ -0,0 +1,10 @@
+package org.turbowarp.android
+
+import androidx.compose.runtime.Composable
+
+@Composable
+fun AddonsView() {
+ TurboWarpWebView(
+ url = "https://editor.android-assets.turbowarp.org/addons/addons.html",
+ )
+}
diff --git a/android/app/src/main/java/org/turbowarp/android/Assets.kt b/android/app/src/main/java/org/turbowarp/android/Assets.kt
new file mode 100644
index 00000000..fcefdbd4
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/Assets.kt
@@ -0,0 +1,17 @@
+package org.turbowarp.android
+
+import android.content.Context
+import org.brotli.dec.BrotliInputStream
+import java.io.InputStream
+
+fun readAssetAsString(context: Context, path: String): String {
+ val stream = context.assets.open(path)
+ val reader = stream.bufferedReader()
+ return reader.readText()
+}
+
+fun readBrotliAssetAsStream(context: Context, path: String): InputStream {
+ val compressedDataStream = context.assets.open(path)
+ val decompressedDataStream = BrotliInputStream(compressedDataStream)
+ return decompressedDataStream
+}
\ No newline at end of file
diff --git a/android/app/src/main/java/org/turbowarp/android/EditorView.kt b/android/app/src/main/java/org/turbowarp/android/EditorView.kt
new file mode 100644
index 00000000..ae8ca37b
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/EditorView.kt
@@ -0,0 +1,89 @@
+package org.turbowarp.android
+
+import android.os.Handler
+import android.os.Looper
+import androidx.compose.foundation.layout.Box
+import androidx.compose.runtime.Composable
+import androidx.navigation.compose.NavHost
+import androidx.navigation.compose.composable
+import androidx.navigation.compose.rememberNavController
+import org.json.JSONArray
+import org.json.JSONObject
+
+fun mapToJsonObject(map: Map): JSONObject {
+ val jsonObject = JSONObject()
+ for ((key, value) in map) {
+ jsonObject.put(key, value)
+ }
+ return jsonObject
+}
+
+@Composable
+fun EditorView() {
+ val navController = rememberNavController()
+
+ val editor = TurboWarpWebView(
+ url = "https://editor.android-assets.turbowarp.org/gui/gui.html",
+ preloads = listOf(
+ "editor.js",
+ ),
+ ipcHandler = object : IpcHandler {
+ override fun handleSync(
+ method: String,
+ args: JSONArray
+ ): Any? {
+ if (method == "is-initially-fullscreen") {
+ return false
+ }
+
+ if (method == "set-locale") {
+ val result = JSONObject()
+ val strings = L10N.getStrings()
+ result.put("strings", mapToJsonObject(strings))
+ return result
+ }
+
+ if (method == "open-about") {
+ Handler(Looper.getMainLooper()).post {
+ navController.navigate("about")
+ }
+ return null
+ }
+
+ if (method == "open-addon-settings") {
+ Handler(Looper.getMainLooper()).post {
+ navController.navigate("addons")
+ }
+ return null
+ }
+
+ if (method == "open-privacy") {
+ Handler(Looper.getMainLooper()).post {
+ navController.navigate("privacy")
+ }
+ return null
+ }
+
+ return null
+ }
+ }
+ )
+
+ Box {
+ editor
+ NavHost(navController = navController, startDestination = "none") {
+ composable("none") {
+ // empty
+ }
+ composable("about") {
+ AboutView()
+ }
+ composable("addons") {
+ AddonsView()
+ }
+ composable("privacy") {
+ PrivacyView()
+ }
+ }
+ }
+}
diff --git a/android/app/src/main/java/org/turbowarp/android/L10N.kt b/android/app/src/main/java/org/turbowarp/android/L10N.kt
new file mode 100644
index 00000000..3adfe27e
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/L10N.kt
@@ -0,0 +1,42 @@
+package org.turbowarp.android
+
+import android.content.Context
+import org.json.JSONObject
+
+object L10N {
+ private val translations = mutableMapOf>()
+
+ private fun stringsWithDescriptionToMap(jsonObject: JSONObject): Map {
+ val map = mutableMapOf()
+ for (id in jsonObject.keys()) {
+ val infoObject = jsonObject.getJSONObject(id)
+ map[id] = infoObject.getString("string")
+ }
+ return map
+ }
+
+ private fun stringsToMap(jsonObject: JSONObject): Map {
+ val map = mutableMapOf()
+ for (id in jsonObject.keys()) {
+ map[id] = jsonObject.getString(id)
+ }
+ return map
+ }
+
+ fun setup(context: Context) {
+ val englishStrings = readAssetAsString(context, "l10n/en.json")
+ val englishStringsObject = JSONObject(englishStrings)
+ translations["en"] = stringsWithDescriptionToMap(englishStringsObject)
+
+ val translatedStrings = readAssetAsString(context, "l10n/generated-translations.json")
+ val translatedStringsObjects = JSONObject(translatedStrings)
+ for (locale in translatedStringsObjects.keys()) {
+ val localeStringsObject = translatedStringsObjects.getJSONObject(locale)
+ translations[locale] = stringsToMap(localeStringsObject)
+ }
+ }
+
+ fun getStrings(): Map {
+ return translations["en"]!!
+ }
+}
\ No newline at end of file
diff --git a/android/app/src/main/java/org/turbowarp/android/MainActivity.kt b/android/app/src/main/java/org/turbowarp/android/MainActivity.kt
new file mode 100644
index 00000000..9192952b
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/MainActivity.kt
@@ -0,0 +1,32 @@
+package org.turbowarp.android
+
+import android.os.Bundle
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.activity.enableEdgeToEdge
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.safeDrawingPadding
+import androidx.compose.ui.Modifier
+import androidx.navigation.compose.rememberNavController
+import androidx.webkit.WebViewFeature
+import org.turbowarp.android.ui.theme.TurboWarpTheme
+
+// TODO
+private fun isDeviceSupported(): Boolean {
+ return WebViewFeature.isFeatureSupported(WebViewFeature.WEB_MESSAGE_LISTENER)
+}
+
+class MainActivity : ComponentActivity() {
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+ enableEdgeToEdge()
+ L10N.setup(applicationContext)
+ setContent {
+ TurboWarpTheme {
+ Box(modifier = Modifier.safeDrawingPadding()) {
+ EditorView()
+ }
+ }
+ }
+ }
+}
diff --git a/android/app/src/main/java/org/turbowarp/android/PrivacyView.kt b/android/app/src/main/java/org/turbowarp/android/PrivacyView.kt
new file mode 100644
index 00000000..c5965f34
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/PrivacyView.kt
@@ -0,0 +1,18 @@
+package org.turbowarp.android
+
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+
+@Composable
+fun PrivacyView() {
+ Surface(
+ modifier = Modifier.fillMaxSize(),
+ color = Color.White
+ ) {
+ Text("Testing")
+ }
+}
\ No newline at end of file
diff --git a/android/app/src/main/java/org/turbowarp/android/TurboWarpWebView.kt b/android/app/src/main/java/org/turbowarp/android/TurboWarpWebView.kt
new file mode 100644
index 00000000..a9957885
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/TurboWarpWebView.kt
@@ -0,0 +1,287 @@
+package org.turbowarp.android
+
+import android.annotation.SuppressLint
+import android.content.Context
+import android.content.Intent
+import android.graphics.Bitmap
+import android.net.Uri
+import android.view.ViewGroup
+import android.webkit.JavascriptInterface
+import android.webkit.WebResourceRequest
+import android.webkit.WebResourceResponse
+import android.webkit.WebView
+import android.webkit.WebViewClient
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.viewinterop.AndroidView
+import androidx.webkit.JavaScriptReplyProxy
+import androidx.webkit.WebMessageCompat
+import androidx.webkit.WebViewAssetLoader
+import androidx.webkit.WebViewCompat
+import java.io.IOException
+import java.net.URLConnection
+import androidx.core.net.toUri
+import org.json.JSONArray
+import org.json.JSONObject
+import java.io.InputStream
+
+private fun addIndexIfNeeded(path: String): String {
+ return if (path.endsWith("/")) {
+ "$path/index.html"
+ } else {
+ path
+ }
+}
+
+private fun makeFetchableResponse(data: InputStream, path: String): WebResourceResponse {
+ // TODO: use our own mime types instead of the system's
+ val mimeType = URLConnection.guessContentTypeFromName(path)
+
+ return WebResourceResponse(
+ mimeType,
+ null,
+ 200,
+ "OK",
+ mapOf(
+ "Access-Control-Allow-Origin" to "*"
+ ),
+ data,
+ )
+}
+
+private fun makeErrorResponse(): WebResourceResponse {
+ // TODO
+ return WebResourceResponse(null, null, null)
+}
+
+private class ServeAsset(
+ private val context: Context,
+ private val subfolder: String
+) : WebViewAssetLoader.PathHandler {
+ override fun handle(path: String): WebResourceResponse? {
+ return try {
+ // TODO: probably vulnerable to path traversal
+ val pathWithIndex = addIndexIfNeeded(path)
+ val assetPath = "$subfolder/$pathWithIndex"
+
+ val stream = context.assets.open(assetPath)
+ makeFetchableResponse(stream, pathWithIndex)
+ } catch (_: IOException) {
+ makeErrorResponse()
+ }
+ }
+}
+
+private class ServeBrotliAsset(
+ private val context: Context,
+ private val subfolder: String
+) : WebViewAssetLoader.PathHandler {
+ override fun handle(path: String): WebResourceResponse? {
+ return try {
+ // TODO: probably vulnerable to path traversal
+ val pathWithIndex = addIndexIfNeeded(path)
+ val compressedAssetPath = "$subfolder/$pathWithIndex.br"
+
+ val stream = readBrotliAssetAsStream(context, compressedAssetPath)
+ makeFetchableResponse(stream, pathWithIndex)
+ } catch (_: IOException) {
+ // TODO: does this fall-through to remote or error?
+ null
+ }
+ }
+}
+
+private class ServeLibraryAsset(
+ private val context: Context,
+ private val subfolder: String
+) : WebViewAssetLoader.PathHandler {
+ private fun findMd5ext(path: String): String? {
+ val md5ext = Regex("[0-9a-f]{32}\\.\\w{3}", RegexOption.IGNORE_CASE).find(path)
+ return md5ext?.value
+ }
+
+ override fun handle(path: String): WebResourceResponse? {
+ return try {
+ val md5ext = findMd5ext(path)
+
+ if (md5ext == null) {
+ makeErrorResponse()
+ } else {
+ val compressedAssetPath = "$subfolder/$md5ext.br"
+ val stream = readBrotliAssetAsStream(context, compressedAssetPath)
+ makeFetchableResponse(stream, md5ext)
+ }
+ } catch (_: IOException) {
+ makeErrorResponse()
+ }
+ }
+}
+
+private class TurboWarpWebViewClient(
+ private val context: Context,
+ private val preloads: List,
+ private val initialUrl: String
+) : WebViewClient() {
+ private val assetLoaders = mapOf(
+ "editor.android-assets.turbowarp.org" to WebViewAssetLoader.Builder()
+ .setDomain("editor.android-assets.turbowarp.org")
+ .addPathHandler("/", ServeAsset(context, "dist-renderer-webpack/editor"))
+ .build(),
+
+ "extensions.turbowarp.org" to WebViewAssetLoader.Builder()
+ .setDomain("extensions.turbowarp.org")
+ .addPathHandler("/", ServeBrotliAsset(context, "dist-extensions"))
+ .build(),
+
+ "assets.scratch.mit.edu" to WebViewAssetLoader.Builder()
+ .setDomain("assets.scratch.mit.edu")
+ .addPathHandler("/", ServeLibraryAsset(context, "dist-library-files"))
+ .build(),
+
+ "cdn.assets.scratch.mit.edu" to WebViewAssetLoader.Builder()
+ .setDomain("cdn.assets.scratch.mit.edu")
+ .addPathHandler("/", ServeLibraryAsset(context, "dist-library-files"))
+ .build(),
+
+ "packager.turbowarp.org" to WebViewAssetLoader.Builder()
+ .setDomain("packager.turbowarp.org")
+ .addPathHandler("/", ServeAsset(context, "packager"))
+ .build(),
+ )
+
+ override fun onPageStarted(view: WebView?, url: String?, favicon: Bitmap?) {
+ super.onPageStarted(view, url, favicon)
+
+ // Execute preloads in IIFE so that we only expose the variables we want to
+ val sb = StringBuilder()
+ sb.append("(function() { 'use strict';\n")
+ for (preloadName in preloads) {
+ // We assume that the preloads variable is trusted, don't need to worry about path
+ // traversal or anything like that.
+ val preloadScript = readAssetAsString(context, "preload/$preloadName")
+ sb.append(preloadScript)
+ }
+ sb.append("\n}());")
+
+ view?.evaluateJavascript(sb.toString(), null)
+ }
+
+ override fun shouldInterceptRequest(
+ view: WebView,
+ request: WebResourceRequest
+ ): WebResourceResponse? {
+ val loader = request.url.host?.let { assetLoaders[it] }
+ return loader?.shouldInterceptRequest(request.url)
+ }
+
+ override fun shouldOverrideUrlLoading(view: WebView?, request: WebResourceRequest?): Boolean {
+ // Open links in browser app
+ // TODO: can we make this feel a bit less weird? like that custom tabs thing?
+ if (request?.url.toString() != initialUrl) {
+ val intent = Intent(Intent.ACTION_VIEW, request?.url)
+ view?.context?.startActivity(intent)
+ return true
+ }
+
+ return super.shouldOverrideUrlLoading(view, request)
+ }
+}
+
+interface IpcHandler {
+ fun handleSync(method: String, args: JSONArray): Any?
+}
+
+private class IpcSync(private val ipcHandler: IpcHandler) {
+ // Android's JavaScript interface apparently only supports the primitive types.
+ // So we have to pass around JSON strings. Real fun.
+ @JavascriptInterface
+ fun sendSync(jsonRequestString: String): String {
+ val jsonRequest = JSONObject(jsonRequestString)
+ val method = jsonRequest.getString("method")
+ val args = jsonRequest.getJSONArray("args")
+
+ val jsonResponse = ipcHandler.handleSync(method, args)
+ return jsonResponse?.toString() ?: "null"
+ }
+}
+
+private class IpcAsync(private val ipcHandler: IpcHandler) : WebViewCompat.WebMessageListener {
+ @SuppressLint("RequiresFeature")
+ override fun onPostMessage(
+ view: WebView,
+ message: WebMessageCompat,
+ sourceOrigin: Uri,
+ isMainFrame: Boolean,
+ replyProxy: JavaScriptReplyProxy
+ ) {
+ replyProxy.postMessage("e")
+ }
+}
+
+private fun getOrigin(url: String): String {
+ val uri = url.toUri()
+ val sb = StringBuilder()
+ sb.append(uri.scheme)
+ sb.append("://")
+ sb.append(uri.host)
+ return sb.toString()
+}
+
+@SuppressLint("SetJavaScriptEnabled", "RequiresFeature")
+@Composable
+fun TurboWarpWebView(
+ url: String,
+ modifier: Modifier = Modifier,
+ preloads: List = emptyList(),
+ ipcHandler: IpcHandler? = null
+) {
+ AndroidView(
+ modifier = modifier,
+ factory = { context ->
+ WebView(context).apply {
+ layoutParams = ViewGroup.LayoutParams(
+ ViewGroup.LayoutParams.MATCH_PARENT,
+ ViewGroup.LayoutParams.MATCH_PARENT
+ )
+
+ // Enable standard web APIs
+ settings.javaScriptEnabled = true
+ settings.domStorageEnabled = true
+
+ // All of our assets come through custom asset loaders, so
+ // don't disable file access, like browsers do.
+ settings.allowFileAccess = false
+ settings.allowContentAccess = false
+
+ // To help troubleshooting
+ val version = BuildConfig.VERSION_NAME
+ val appId = BuildConfig.APPLICATION_ID
+ settings.userAgentString += " $appId/$version"
+
+ if (ipcHandler != null) {
+ val origin = getOrigin(url)
+ WebViewCompat.addWebMessageListener(
+ this,
+ "AndroidIpcAsync",
+ setOf(origin),
+ IpcAsync(ipcHandler)
+ )
+ addJavascriptInterface(IpcSync(ipcHandler), "AndroidIpcSync")
+ }
+
+ webViewClient = TurboWarpWebViewClient(
+ context = context,
+ initialUrl = url,
+ preloads = if (ipcHandler == null) {
+ preloads
+ } else {
+ listOf("ipc-init.js").plus(preloads)
+ }
+ )
+ }
+ },
+ update = { webView ->
+ webView.loadUrl(url)
+ }
+ )
+}
diff --git a/android/app/src/main/java/org/turbowarp/android/ui/theme/Color.kt b/android/app/src/main/java/org/turbowarp/android/ui/theme/Color.kt
new file mode 100644
index 00000000..a7e222bc
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/ui/theme/Color.kt
@@ -0,0 +1,11 @@
+package org.turbowarp.android.ui.theme
+
+import androidx.compose.ui.graphics.Color
+
+val Purple80 = Color(0xFFD0BCFF)
+val PurpleGrey80 = Color(0xFFCCC2DC)
+val Pink80 = Color(0xFFEFB8C8)
+
+val Purple40 = Color(0xFF6650a4)
+val PurpleGrey40 = Color(0xFF625b71)
+val Pink40 = Color(0xFF7D5260)
\ No newline at end of file
diff --git a/android/app/src/main/java/org/turbowarp/android/ui/theme/Theme.kt b/android/app/src/main/java/org/turbowarp/android/ui/theme/Theme.kt
new file mode 100644
index 00000000..d44a5974
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/ui/theme/Theme.kt
@@ -0,0 +1,58 @@
+package org.turbowarp.android.ui.theme
+
+import android.app.Activity
+import android.os.Build
+import androidx.compose.foundation.isSystemInDarkTheme
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.darkColorScheme
+import androidx.compose.material3.dynamicDarkColorScheme
+import androidx.compose.material3.dynamicLightColorScheme
+import androidx.compose.material3.lightColorScheme
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.platform.LocalContext
+
+private val DarkColorScheme = darkColorScheme(
+ primary = Purple80,
+ secondary = PurpleGrey80,
+ tertiary = Pink80
+)
+
+private val LightColorScheme = lightColorScheme(
+ primary = Purple40,
+ secondary = PurpleGrey40,
+ tertiary = Pink40
+
+ /* Other default colors to override
+ background = Color(0xFFFFFBFE),
+ surface = Color(0xFFFFFBFE),
+ onPrimary = Color.White,
+ onSecondary = Color.White,
+ onTertiary = Color.White,
+ onBackground = Color(0xFF1C1B1F),
+ onSurface = Color(0xFF1C1B1F),
+ */
+)
+
+@Composable
+fun TurboWarpTheme(
+ darkTheme: Boolean = isSystemInDarkTheme(),
+ // Dynamic color is available on Android 12+
+ dynamicColor: Boolean = true,
+ content: @Composable () -> Unit
+) {
+ val colorScheme = when {
+ dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
+ val context = LocalContext.current
+ if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
+ }
+
+ darkTheme -> DarkColorScheme
+ else -> LightColorScheme
+ }
+
+ MaterialTheme(
+ colorScheme = colorScheme,
+ typography = Typography,
+ content = content
+ )
+}
\ No newline at end of file
diff --git a/android/app/src/main/java/org/turbowarp/android/ui/theme/Type.kt b/android/app/src/main/java/org/turbowarp/android/ui/theme/Type.kt
new file mode 100644
index 00000000..9a73b7b4
--- /dev/null
+++ b/android/app/src/main/java/org/turbowarp/android/ui/theme/Type.kt
@@ -0,0 +1,34 @@
+package org.turbowarp.android.ui.theme
+
+import androidx.compose.material3.Typography
+import androidx.compose.ui.text.TextStyle
+import androidx.compose.ui.text.font.FontFamily
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.sp
+
+// Set of Material typography styles to start with
+val Typography = Typography(
+ bodyLarge = TextStyle(
+ fontFamily = FontFamily.Default,
+ fontWeight = FontWeight.Normal,
+ fontSize = 16.sp,
+ lineHeight = 24.sp,
+ letterSpacing = 0.5.sp
+ )
+ /* Other default text styles to override
+ titleLarge = TextStyle(
+ fontFamily = FontFamily.Default,
+ fontWeight = FontWeight.Normal,
+ fontSize = 22.sp,
+ lineHeight = 28.sp,
+ letterSpacing = 0.sp
+ ),
+ labelSmall = TextStyle(
+ fontFamily = FontFamily.Default,
+ fontWeight = FontWeight.Medium,
+ fontSize = 11.sp,
+ lineHeight = 16.sp,
+ letterSpacing = 0.5.sp
+ )
+ */
+)
\ No newline at end of file
diff --git a/android/app/src/main/res/drawable/ic_launcher_foreground.xml b/android/app/src/main/res/drawable/ic_launcher_foreground.xml
new file mode 100644
index 00000000..09d5bce4
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_launcher_foreground.xml
@@ -0,0 +1,16 @@
+
+
+
+
+
diff --git a/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 00000000..7353dbd1
--- /dev/null
+++ b/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,5 @@
+
+
+
+
+
\ No newline at end of file
diff --git a/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
new file mode 100644
index 00000000..7353dbd1
--- /dev/null
+++ b/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -0,0 +1,5 @@
+
+
+
+
+
\ No newline at end of file
diff --git a/android/app/src/main/res/mipmap-hdpi/ic_launcher.webp b/android/app/src/main/res/mipmap-hdpi/ic_launcher.webp
new file mode 100644
index 00000000..8aaa9ea3
Binary files /dev/null and b/android/app/src/main/res/mipmap-hdpi/ic_launcher.webp differ
diff --git a/android/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp b/android/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp
new file mode 100644
index 00000000..8aaa9ea3
Binary files /dev/null and b/android/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp differ
diff --git a/android/app/src/main/res/mipmap-mdpi/ic_launcher.webp b/android/app/src/main/res/mipmap-mdpi/ic_launcher.webp
new file mode 100644
index 00000000..93e61032
Binary files /dev/null and b/android/app/src/main/res/mipmap-mdpi/ic_launcher.webp differ
diff --git a/android/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp b/android/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp
new file mode 100644
index 00000000..93e61032
Binary files /dev/null and b/android/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp differ
diff --git a/android/app/src/main/res/mipmap-xhdpi/ic_launcher.webp b/android/app/src/main/res/mipmap-xhdpi/ic_launcher.webp
new file mode 100644
index 00000000..d1dddc72
Binary files /dev/null and b/android/app/src/main/res/mipmap-xhdpi/ic_launcher.webp differ
diff --git a/android/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp b/android/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp
new file mode 100644
index 00000000..d1dddc72
Binary files /dev/null and b/android/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp differ
diff --git a/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp b/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp
new file mode 100644
index 00000000..cdd69ee9
Binary files /dev/null and b/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp differ
diff --git a/android/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp b/android/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp
new file mode 100644
index 00000000..cdd69ee9
Binary files /dev/null and b/android/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp differ
diff --git a/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp b/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp
new file mode 100644
index 00000000..97de11c5
Binary files /dev/null and b/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp differ
diff --git a/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp b/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp
new file mode 100644
index 00000000..97de11c5
Binary files /dev/null and b/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp differ
diff --git a/android/app/src/main/res/values-night/styles.xml b/android/app/src/main/res/values-night/styles.xml
new file mode 100644
index 00000000..6b30d8d9
--- /dev/null
+++ b/android/app/src/main/res/values-night/styles.xml
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/android/app/src/main/res/values/attrs_my_view.xml b/android/app/src/main/res/values/attrs_my_view.xml
new file mode 100644
index 00000000..e5f8fdc2
--- /dev/null
+++ b/android/app/src/main/res/values/attrs_my_view.xml
@@ -0,0 +1,2 @@
+
+
\ No newline at end of file
diff --git a/android/app/src/main/res/values/colors.xml b/android/app/src/main/res/values/colors.xml
new file mode 100644
index 00000000..66e3f6cf
--- /dev/null
+++ b/android/app/src/main/res/values/colors.xml
@@ -0,0 +1,14 @@
+
+
+ #FFBB86FC
+ #FF6200EE
+ #FF3700B3
+ #FF03DAC5
+ #FF018786
+ #FF000000
+ #FFFFFFFF
+ #FF29B6F6
+ #FF039BE5
+ #FFBDBDBD
+ #FF757575
+
\ No newline at end of file
diff --git a/android/app/src/main/res/values/ic_launcher_background.xml b/android/app/src/main/res/values/ic_launcher_background.xml
new file mode 100644
index 00000000..60904177
--- /dev/null
+++ b/android/app/src/main/res/values/ic_launcher_background.xml
@@ -0,0 +1,4 @@
+
+
+ #FF4C4C
+
\ No newline at end of file
diff --git a/android/app/src/main/res/values/strings.xml b/android/app/src/main/res/values/strings.xml
new file mode 100644
index 00000000..ad3799d1
--- /dev/null
+++ b/android/app/src/main/res/values/strings.xml
@@ -0,0 +1,3 @@
+
+ TurboWarp
+
\ No newline at end of file
diff --git a/android/app/src/main/res/values/styles.xml b/android/app/src/main/res/values/styles.xml
new file mode 100644
index 00000000..6b30d8d9
--- /dev/null
+++ b/android/app/src/main/res/values/styles.xml
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/android/app/src/main/res/values/themes.xml b/android/app/src/main/res/values/themes.xml
new file mode 100644
index 00000000..3bffc1cc
--- /dev/null
+++ b/android/app/src/main/res/values/themes.xml
@@ -0,0 +1,4 @@
+
+
+
+
\ No newline at end of file
diff --git a/android/app/src/main/res/xml/backup_rules.xml b/android/app/src/main/res/xml/backup_rules.xml
new file mode 100644
index 00000000..4df92558
--- /dev/null
+++ b/android/app/src/main/res/xml/backup_rules.xml
@@ -0,0 +1,13 @@
+
+
+
+
\ No newline at end of file
diff --git a/android/app/src/main/res/xml/data_extraction_rules.xml b/android/app/src/main/res/xml/data_extraction_rules.xml
new file mode 100644
index 00000000..9ee9997b
--- /dev/null
+++ b/android/app/src/main/res/xml/data_extraction_rules.xml
@@ -0,0 +1,19 @@
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/android/app/src/test/java/org/turbowarp/android/ExampleUnitTest.kt b/android/app/src/test/java/org/turbowarp/android/ExampleUnitTest.kt
new file mode 100644
index 00000000..e59c1aa6
--- /dev/null
+++ b/android/app/src/test/java/org/turbowarp/android/ExampleUnitTest.kt
@@ -0,0 +1,17 @@
+package org.turbowarp.android
+
+import org.junit.Test
+
+import org.junit.Assert.*
+
+/**
+ * Example local unit test, which will execute on the development machine (host).
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+class ExampleUnitTest {
+ @Test
+ fun addition_isCorrect() {
+ assertEquals(4, 2 + 2)
+ }
+}
\ No newline at end of file
diff --git a/android/build.gradle.kts b/android/build.gradle.kts
new file mode 100644
index 00000000..952b9306
--- /dev/null
+++ b/android/build.gradle.kts
@@ -0,0 +1,6 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+plugins {
+ alias(libs.plugins.android.application) apply false
+ alias(libs.plugins.kotlin.android) apply false
+ alias(libs.plugins.kotlin.compose) apply false
+}
\ No newline at end of file
diff --git a/android/gradle.properties b/android/gradle.properties
new file mode 100644
index 00000000..20e2a015
--- /dev/null
+++ b/android/gradle.properties
@@ -0,0 +1,23 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. For more details, visit
+# https://developer.android.com/r/tools/gradle-multi-project-decoupled-projects
+# org.gradle.parallel=true
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app's APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=true
+# Kotlin code style for this project: "official" or "obsolete":
+kotlin.code.style=official
+# Enables namespacing of each library's R class so that its R class includes only the
+# resources declared in the library itself and none from the library's dependencies,
+# thereby reducing the size of the R class for that library
+android.nonTransitiveRClass=true
\ No newline at end of file
diff --git a/android/gradle/libs.versions.toml b/android/gradle/libs.versions.toml
new file mode 100644
index 00000000..ca592ced
--- /dev/null
+++ b/android/gradle/libs.versions.toml
@@ -0,0 +1,46 @@
+[versions]
+agp = "8.13.0"
+brotlidec = "0.1.2"
+kotlin = "2.0.21"
+coreKtx = "1.10.1"
+junit = "4.13.2"
+junitVersion = "1.1.5"
+espressoCore = "3.5.1"
+lifecycleRuntimeKtx = "2.6.1"
+activityCompose = "1.8.0"
+composeBom = "2024.09.00"
+appcompat = "1.6.1"
+material = "1.10.0"
+activity = "1.11.0"
+constraintlayout = "2.1.4"
+webkit = "1.14.0"
+navigationCompose = "2.7.7"
+
+[libraries]
+androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
+androidx-webkit = { module = "androidx.webkit:webkit", version.ref = "webkit" }
+brotlidec = { module = "org.brotli:dec", version.ref = "brotlidec" }
+junit = { group = "junit", name = "junit", version.ref = "junit" }
+androidx-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junitVersion" }
+androidx-espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version.ref = "espressoCore" }
+androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycleRuntimeKtx" }
+androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
+androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
+androidx-compose-ui = { group = "androidx.compose.ui", name = "ui" }
+androidx-compose-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics" }
+androidx-compose-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling" }
+androidx-compose-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview" }
+androidx-compose-ui-test-manifest = { group = "androidx.compose.ui", name = "ui-test-manifest" }
+androidx-compose-ui-test-junit4 = { group = "androidx.compose.ui", name = "ui-test-junit4" }
+androidx-compose-material3 = { group = "androidx.compose.material3", name = "material3" }
+androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
+material = { group = "com.google.android.material", name = "material", version.ref = "material" }
+androidx-activity = { group = "androidx.activity", name = "activity", version.ref = "activity" }
+androidx-constraintlayout = { group = "androidx.constraintlayout", name = "constraintlayout", version.ref = "constraintlayout" }
+androidx-navigation-compose = { group = "androidx.navigation", name = "navigation-compose", version.ref = "navigationCompose" }
+
+[plugins]
+android-application = { id = "com.android.application", version.ref = "agp" }
+kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
+kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
+
diff --git a/android/gradle/wrapper/gradle-wrapper.jar b/android/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 00000000..8bdaf60c
Binary files /dev/null and b/android/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/android/gradle/wrapper/gradle-wrapper.properties b/android/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 00000000..ac0e1f65
--- /dev/null
+++ b/android/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,8 @@
+#Sun Nov 09 15:47:02 CST 2025
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/android/gradlew b/android/gradlew
new file mode 100755
index 00000000..ef07e016
--- /dev/null
+++ b/android/gradlew
@@ -0,0 +1,251 @@
+#!/bin/sh
+
+#
+# Copyright © 2015 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+# Gradle start up script for POSIX generated by Gradle.
+#
+# Important for running:
+#
+# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+# noncompliant, but you have some other compliant shell such as ksh or
+# bash, then to run this script, type that shell name before the whole
+# command line, like:
+#
+# ksh Gradle
+#
+# Busybox and similar reduced shells will NOT work, because this script
+# requires all of these POSIX shell features:
+# * functions;
+# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+# * compound commands having a testable exit status, especially «case»;
+# * various built-in commands including «command», «set», and «ulimit».
+#
+# Important for patching:
+#
+# (2) This script targets any POSIX shell, so it avoids extensions provided
+# by Bash, Ksh, etc; in particular arrays are avoided.
+#
+# The "traditional" practice of packing multiple parameters into a
+# space-separated string is a well documented source of bugs and security
+# problems, so this is (mostly) avoided, by progressively accumulating
+# options in "$@", and eventually passing that to Java.
+#
+# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+# see the in-line comments for details.
+#
+# There are tweaks for specific operating systems such as AIX, CygWin,
+# Darwin, MinGW, and NonStop.
+#
+# (3) This script is generated from the Groovy template
+# https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+# within the Gradle project.
+#
+# You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+ APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
+ [ -h "$app_path" ]
+do
+ ls=$( ls -ld "$app_path" )
+ link=${ls#*' -> '}
+ case $link in #(
+ /*) app_path=$link ;; #(
+ *) app_path=$APP_HOME$link ;;
+ esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+ echo "$*"
+} >&2
+
+die () {
+ echo
+ echo "$*"
+ echo
+ exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in #(
+ CYGWIN* ) cygwin=true ;; #(
+ Darwin* ) darwin=true ;; #(
+ MSYS* | MINGW* ) msys=true ;; #(
+ NONSTOP* ) nonstop=true ;;
+esac
+
+CLASSPATH="\\\"\\\""
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD=$JAVA_HOME/jre/sh/java
+ else
+ JAVACMD=$JAVA_HOME/bin/java
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD=java
+ if ! command -v java >/dev/null 2>&1
+ then
+ die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+ case $MAX_FD in #(
+ max*)
+ # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+ # shellcheck disable=SC2039,SC3045
+ MAX_FD=$( ulimit -H -n ) ||
+ warn "Could not query maximum file descriptor limit"
+ esac
+ case $MAX_FD in #(
+ '' | soft) :;; #(
+ *)
+ # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+ # shellcheck disable=SC2039,SC3045
+ ulimit -n "$MAX_FD" ||
+ warn "Could not set maximum file descriptor limit to $MAX_FD"
+ esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+# * args from the command line
+# * the main class name
+# * -classpath
+# * -D...appname settings
+# * --module-path (only if needed)
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+ APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+ CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+ JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ for arg do
+ if
+ case $arg in #(
+ -*) false ;; # don't mess with options #(
+ /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
+ [ -e "$t" ] ;; #(
+ *) false ;;
+ esac
+ then
+ arg=$( cygpath --path --ignore --mixed "$arg" )
+ fi
+ # Roll the args list around exactly as many times as the number of
+ # args, so each arg winds up back in the position where it started, but
+ # possibly modified.
+ #
+ # NB: a `for` loop captures its iteration list before it begins, so
+ # changing the positional parameters here affects neither the number of
+ # iterations, nor the values presented in `arg`.
+ shift # remove old arg
+ set -- "$@" "$arg" # push replacement arg
+ done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+# and any embedded shellness will be escaped.
+# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+# treated as '${Hostname}' itself on the command line.
+
+set -- \
+ "-Dorg.gradle.appname=$APP_BASE_NAME" \
+ -classpath "$CLASSPATH" \
+ -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+ "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+ die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+# set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+ printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+ xargs -n1 |
+ sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+ tr '\n' ' '
+ )" '"$@"'
+
+exec "$JAVACMD" "$@"
diff --git a/android/gradlew.bat b/android/gradlew.bat
new file mode 100644
index 00000000..5eed7ee8
--- /dev/null
+++ b/android/gradlew.bat
@@ -0,0 +1,94 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/android/settings.gradle.kts b/android/settings.gradle.kts
new file mode 100644
index 00000000..da03dc26
--- /dev/null
+++ b/android/settings.gradle.kts
@@ -0,0 +1,23 @@
+pluginManagement {
+ repositories {
+ google {
+ content {
+ includeGroupByRegex("com\\.android.*")
+ includeGroupByRegex("com\\.google.*")
+ includeGroupByRegex("androidx.*")
+ }
+ }
+ mavenCentral()
+ gradlePluginPortal()
+ }
+}
+dependencyResolutionManagement {
+ repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+ repositories {
+ google()
+ mavenCentral()
+ }
+}
+
+rootProject.name = "TurboWarp"
+include(":app")
diff --git a/art/android-foreground.svg b/art/android-foreground.svg
new file mode 100644
index 00000000..4cd2bf66
--- /dev/null
+++ b/art/android-foreground.svg
@@ -0,0 +1,46 @@
+
+
+
+
+
+
+
+
diff --git a/docs/index.html b/docs/index.html
index 9fe5ecda..7637437c 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -532,10 +532,10 @@