drukscode/drukscode-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
drukscode-v2/docs/developer/index.md
OpenCode AI e9899d2e6d
Some checks failed
Android CI Build / check (push) Has been cancelled
Details
Android CI Build / package-apks (push) Has been cancelled
Details
Docs Deploy / build (push) Has been cancelled
Details
Module Market Check / Validate modules/ (push) Has been cancelled
Details
Module Market Publish / Generate submissions.json (push) Has been cancelled
Details
Docs Deploy / deploy (push) Has been cancelled
Details
Initial DruksCode V2: fresh fork of web-to-app (f3b488e) with DruksCode identity 
- Package rename com.webtoapp -> br.com.drukstech.codeapp
- Product rename WebToApp/web-to-app -> DruksCode/drukscode
- Design system Wta* -> Dkc*
- applicationId br.com.drukstech.codeapp (.play for gplay flavor)
- rootProject.name DruksCode
- Fresh git history (upstream kept as remote for sync)
2026-09-12 02:42:02 +02:00

3.0 KiB
Raw Permalink Blame History

Developer Docs

This section is for people working on DruksCode itself — contributors, deep customizers, and AI coding agents. It explains how the codebase is organized and how the two things that trip everyone up actually work: the export pipeline and shell sync.

::: tip Authoritative reference AGENTS.md at the repo root is the authoritative guide for AI agents and deep contributors. These pages expand on it with more context. :::

Repository layout

Path Role
app/ Full builder host: editor UI, export pipeline, runtimes, preview. The main application module.
shell/ Runtime template. Built to app/src/main/assets/template/webview_shell.apk via :shell:assembleRelease + :app:syncShellTemplateApk.
clone-host/ Host-side APK clone / identity reshape support library (compiled to a DEX asset).
modules/ Module Market catalog (registry.json + per-module folders).
scripts/ Build helpers and gates (check_config_field_drift.py).
docs/ This documentation site.

Runtime Kotlin is authored under app/ and synced into shell/ by syncShellRuntimeSources. Edit the app/ source once; do not permanently fork copies under shell/.

The three Gradle modules

  • :app — the builder. applicationId = br.com.drukstech.codeapp, compileSdk = 36, minSdk = 23, targetSdk = 35, buildConfigField SHELL_RUNTIME_ONLY = false.
  • :shell — the runtime template embedded into generated APKs. Same compileSdk/minSdk/version as :app, but targetSdk = 28 (generated apps keep the low targetSdk for fork+exec runtimes) and SHELL_RUNTIME_ONLY = true. Its sources are synced from app/.
  • :clone-host — a minimal com.android.library (namespace br.com.drukstech.codeapp.clone) with no dependencies, compiled to a DEX asset for AppCloner.

Package structure (app/src/main/java/br/com/drukstech/codeapp)

  • core/* — ~53 sub-packages of business/runtime logic: apkbuilder, shell, webview, engine, extension, crypto, nodejs, php, python, golang, wordpress, linux, port, dns, network, adblock, agent, and more.
  • data/* — persistence: Room DAOs, database, type converters, and the WebApp model + nested *Config classes.
  • ui/* — Jetpack Compose screens, components, design system, and the shell UI.
  • di/ — Koin dependency injection.
  • util/ — helpers and constants.

Native C++ lives under app/src/main/cpp/ (crypto, integrity, anti-debug, node_bridge, node_launcher, go_exec_loader).

Where to read next