Skip to content

docs(mobile): document that PHP source ships readable in the app package#428

Open
shanerbaner82 wants to merge 1 commit into
mainfrom
docs/apk-source-visibility
Open

docs(mobile): document that PHP source ships readable in the app package#428
shanerbaner82 wants to merge 1 commit into
mainfrom
docs/apk-source-visibility

Conversation

@shanerbaner82

Copy link
Copy Markdown
Contributor

Prompted by a user report that PHP source files are visible after extracting a production APK (built with mobile v3.3.6) with APKTool/jadx, and asking whether the built-in obfuscation options help.

That's expected behavior — the app bundle ships as a plain asset and the R8/ProGuard options only touch Kotlin/Java — but neither fact was documented, and the configuration page's obfuscate option could easily be read as covering app code.

Security pages (v3 concepts/security.md, v4 digging-deeper/security.md): new "Your code ships with your app" section explaining:

  • the Laravel app is bundled into the APK/IPA and is readable on extraction, like every hybrid framework (and even compiled code decompiles)
  • the R8/ProGuard build options apply to Kotlin/Java only
  • why bundle encryption isn't offered (the key would ship in the same package)
  • the recommended posture: treat bundled code as public, keep secrets server-side, strip env keys via cleanup_env_keys

Configuration pages (v3 + v4 getting-started/configuration.md): the obfuscate bullet now says "Kotlin/Java class and method names", plus a paragraph after the Android Build Configuration section stating these options don't affect the bundled PHP, linking to the new security section.

🤖 Generated with Claude Code

Add 'Your code ships with your app' section to the v3/v4 security pages
explaining the security model (bundled source is readable, encryption
would be theater, keep secrets server-side, use cleanup_env_keys), and
clarify on the v3/v4 configuration pages that the R8/ProGuard build
options only affect Kotlin/Java, not the bundled PHP.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@shanerbaner82 shanerbaner82 requested a review from simonhamp July 15, 2026 12:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant