Android APK Builder Skill

Turn a product brief, design direction, text assets, or an existing web demo into an installable Android APK with Codex.

This skill is built for fast prototype delivery: it helps Codex design the mobile UI, implement meaningful button flows, add safe native capabilities through Capacitor, package the app, validate the APK, and hand you a file that can be installed on Android.

One prompt in. APK out.

Why This Exists

Many app demos fail at the same point: the UI looks good, but buttons do nothing, native permissions are missing, secrets get hardcoded, or nobody actually builds the APK.

android-apk-builder gives Codex a repeatable APK production workflow:

• mobile-first product thinking instead of static mockups
• Capacitor Android packaging for web-based apps
• local/offline demo state when no backend exists
• safe mock flows for payment, AI, SMS, logistics, orders, and support
• real Android build, signing verification, package inspection, and delivery notes

What It Can Build

Use it for:

• one-prompt Android demo apps
• landing-page or web demo to APK conversions
• Next.js / React / Tailwind / Framer Motion mobile wrappers
• static HTML/CSS/JS offline APK demos
• sales demos, investor demos, internal prototypes, PoCs
• apps that need camera, geolocation, browser/map handoff, clipboard/share/dialog flows

It is especially useful when the prompt includes:

• brand style
• page list
• copy/text materials
• desired user flows
• APK installation requirement

Feature Highlights

• End-to-end delivery: design, implement, package, build, validate, and summarize.
• Button semantics: every visible button should navigate, update state, open a modal, request permission, call a native capability, or show fallback behavior.
• Safe native capabilities: geolocation, camera, browser/maps, dialogs, share, clipboard where useful.
• Secret-safe defaults: no API keys, payment secrets, map keys, or signing passwords in APK assets.
• Offline demo mode: localStorage/mock data flows for stable demos without a backend.
• Brand-ready Android shell: app name, package id, splash/launch screen, app icon, theme color, permissions.
• Validation built in: Gradle build, APK signature verification, aapt dump badging, SHA-256, dependency audit, secret scan.

Quick Start

Clone this repository, then install the skill into your Codex skills folder:

./install.sh

Or install manually:

mkdir -p ~/.codex/skills
cp -R skills/android-apk-builder ~/.codex/skills/android-apk-builder

Then ask Codex something like:

我要做一个安卓APK，设计风格是暖橙+纯白，页面包括首页、搜索、商城、个人中心，文本素材如下……请直接生成安卓安装包APK文件。

Codex should use the skill and work all the way through APK generation.

Example Prompt

Build an Android APK demo for a home-care booking platform.
Style: warm orange + white, soft rounded cards, large tap targets.
Pages: splash, home, city selection, search, services, shop, profile.
Required flows: book service, request location, search tags, claim coupon, add to cart, mock checkout, logistics, customer service, privacy consent.
Please generate an installable APK.

More examples live in examples/prompts.

Repository Layout

.
├── skills/android-apk-builder/      # Installable Codex skill
│   ├── SKILL.md                     # Core workflow loaded by Codex
│   ├── references/apk-workflow.md   # Detailed commands and patterns
│   ├── scripts/                     # Skill helper scripts
│   └── agents/openai.yaml           # UI metadata
├── docs/                            # Human-readable tutorials
├── examples/prompts/                # Copy/paste prompt examples
├── templates/static-capacitor-demo/ # Minimal offline APK template
├── scripts/                         # Convenience scripts
└── .github/                         # CI and community templates

Build Helper

The bundled helper can build an existing Capacitor/static project:

bash scripts/build-capacitor-debug-apk.sh /path/to/project my-demo-app

It will try to:

1. discover Node/JDK/Android SDK toolchains,
2. install dependencies if needed,
3. use an existing static www directory or mobile build script,
4. run cap sync android,
5. run Gradle assembleDebug,
6. copy the APK to artifacts/android/<name>.apk,
7. print SHA-256 and APK metadata when tools are available.

Safety Model

This skill intentionally refuses unsafe shortcuts:

• no provider keys embedded in frontend bundles
• no payment secrets in APKs
• no private signing material committed to source
• no fake claim that a real payment, real backend, or real device test happened
• mock flows are labeled as mock flows

For production apps, add a backend/API proxy, release signing, Play Store AAB build, monitoring, analytics, and a privacy/legal review.

Version

Current version: v1.1.0

See CHANGELOG.md for release notes.

Docs

• Getting Started
• One-Prompt APK Tutorial
• Native Capabilities Guide
• Publishing Checklist
• Troubleshooting

Roadmap

• release APK/AAB signing workflow templates
• richer static app starter templates
• Play Store preparation checklist
• optional screenshot generation flow
• native QR/barcode scanner integration examples
• backend proxy examples for AI, SMS, and payments

Contributing

Contributions are welcome. See CONTRIBUTING.md.

If this helped you generate APKs faster, a star helps others find it.

License

MIT License. See LICENSE.