{
  "markdown": "<p align=\"center\">\n  <a href=\"https://github.com/mitunmanav/build-android-apps\">\n    <img src=\"assets/logo.svg\" width=\"92\" height=\"92\" alt=\"Build Android App — green Android head + build stack + Play badge\" />\n  </a>\n</p>\n\n<h1 align=\"center\">Build Android Apps</h1>\n\n<p align=\"center\">\n  <strong>Describe the app in one sentence. Get a working app on Google Play.</strong><br/>\n  No Kotlin. No Gradle. No Console maze.\n</p>\n\n<p align=\"center\">\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square\" alt=\"License: Apache 2.0\" /></a>\n  <a href=\"CHANGELOG.md\"><img src=\"https://img.shields.io/badge/version-2.0.0-3DDC84?style=flat-square\" alt=\"Version 2.0.0\" /></a>\n  <a href=\"SPEC.md\"><img src=\"https://img.shields.io/badge/spec-v2.0-6E56CF?style=flat-square\" alt=\"Spec v2.0\" /></a>\n  <img src=\"https://img.shields.io/badge/platform-Android-3DDC84?style=flat-square&logo=android&logoColor=white\" alt=\"Platform Android\" />\n  <img src=\"https://img.shields.io/badge/hosts-Codex%20%E2%80%A2%20Claude%20%E2%80%A2%20.agents-000?style=flat-square\" alt=\"Hosts: Codex, Claude, .agents\" />\n  <a href=\"https://github.com/mitunmanav/build-android-apps/stargazers\"><img src=\"https://img.shields.io/github/stars/mitunmanav/build-android-apps?style=flat-square&label=stars\" alt=\"GitHub stars\" /></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"#quick-start\">Quick start</a> •\n  <a href=\"#how-it-works\">How it works</a> •\n  <a href=\"#install\">Install</a> •\n  <a href=\"docs/SKILLS-CATALOG.md\">Skills</a> •\n  <a href=\"commands/\">Commands</a> •\n  <a href=\"docs/INSTALL_MATRIX.md\">All hosts</a> •\n  <a href=\"CONTRIBUTING.md\">Contributing</a> •\n  <a href=\"SPEC.md\">Spec</a>\n</p>\n\n---\n\n> **Built for non-technical builders** — indie founders, vibe coders, facilitators.\n> If you can describe the app, the plugin can build it.\n\n```text\n/make-app \"a habit tracker with daily reminders and streaks\"\n# → asks a few questions → writes spec → plans → scaffolds → builds → previews → ships\n```\n\n---\n\n## Quick start\n\nYou handle the Google paperwork: **Play Console account ($25) + ID verification + banking**.\nThe plugin handles everything else: SDK, Gradle, signing, store listing, upload.\n\n```bash\n/setup                                           # first-run wizard: JDK/SDK/adb/device/Play/keystore (~30 min)\n/make-app \"a habit tracker with daily reminders\"  # intake → spec → scaffold\n/run-plan                                         # hands-free build with reviews + device checks\n/preview                                          # install + launch + screenshot\n/publish                                          # gated → signed AAB → Play internal track\n```\n\nTaking over a Lovable / Bolt / v0 / Cursor app? `/import` → `/audit` → `/finish`.\nMid-build changes: `/add` · `/change` · `/remove` · `/where` · `/undo` · `/continue`.\n\n---\n\n## How it works\n\n```mermaid\nflowchart TB\n  Host[AI Host - Codex / Claude / .agents]\n  Manifests[Plugin Manifests + plugin.lock.json]\n  Skills[29 Skills - 1 frontdoor + 28 specialists]\n  Commands[32 Commands - plain English]\n  MCP[5 MCP Servers - adb / gradlew / play-store / keystore / asset]\n  State[state.json - plan / cursor / build / device / store]\n  Router[Kahn Router - deterministic no LLM]\n\n  Host --> Manifests\n  Manifests --> Skills\n  Manifests --> Commands\n  Manifests --> MCP\n  Skills --> State\n  Commands --> State\n  MCP --> State\n  State --> Router\n```\n\nOne frontdoor skill (`$build-android-apps`) routes plain English to the right specialist.\nEvery project gets `<project>/.build-android/state.json`, so `/where` works after you close the laptop.\nDetails: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) · [`SPEC.md`](SPEC.md)\n\n---\n\n## What you get\n\n| You say | Plugin does |\n|---|---|\n| `a habit tracker` | Intake → spec → plan → Compose scaffold with signing + Crashlytics |\n| `/preview` | Install → launch → screenshot on your device |\n| `/publish` | Safety gate → signed AAB → Play internal track |\n| `add dark mode` | Updates the plan, re-runs only affected steps |\n\n---\n\n## Install\n\n**Codex CLI** (v0.122+)\n\n```bash\ncodex plugin marketplace add mitunmanav/build-android-apps\ncodex plugin add build-android-apps@build-android-apps\n```\n\n**Claude Code CLI**\n\n```bash\nclaude plugin marketplace add mitunmanav/build-android-apps\nclaude plugin install build-android-apps@build-android-apps\n```\n\n**Claude Desktop**\n\n```bash\ncp claude_desktop_config.example.json ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n# restart Desktop\n```\n\n**Cursor** — `.cursor/mcp.json` (project) or Team Marketplace `Add Marketplace → https://github.com/mitunmanav/build-android-apps` — hot reload, no restart\n\n**OpenCode**\n\n```bash\n# add to opencode.json plugins, restart, then ask: \"Tell me about your build-android-apps\"\n\"plugin\": [\"build-android-apps@git+https://github.com/mitunmanav/build-android-apps.git\"]\n```\n\n**Pi**\n\n```bash\npi install git:github.com/mitunmanav/build-android-apps\n```\n\n**Kimi Code** — `/plugins install https://github.com/mitunmanav/build-android-apps`\n\n**Antigravity**\n\n```bash\nagy plugin install https://github.com/mitunmanav/build-android-apps\n```\n\n**.agents hosts** (VS Code Copilot / Cursor / Gemini CLI)\n\n```bash\ngit clone https://github.com/mitunmanav/build-android-apps ~/.agents/plugins/build-android-apps\n# restart host\n```\n\n**Gemini CLI** — gemini extensions install https://github.com/mitunmanav/build-android-apps (loads GEMINI.md + skills/)\n\n**Hermes** — `hermes plugins install mitunmanav/build-android-apps --enable`\n\n**Devin** — `devin plugins install mitunmanav/build-android-apps`\n\n**VS Code Copilot** — loads `.github/copilot-instructions.md` automatically (maps via `skills/build-android-apps/references/copilot-tools.md`)\n\nVerify: `bash scripts/smoke.sh`. All hosts: [`docs/INSTALL_MATRIX.md`](docs/INSTALL_MATRIX.md).\nNo telemetry — local `adb`/Gradle/Play API only.\n\n---\n\n## Compatibility\n\nPinned: [`android-scaffold/references/versions-pinned.md`](skills/android-scaffold/references/versions-pinned.md)\n\n| AGP | Gradle | Kotlin | Compose BOM | M3 | min SDK | JVM |\n|---|---|---|---|---|---|---|\n| 8.7+ | 8.9+ | 2.0.21 | 2024.12.01 | 1.3.1 | 26 (Android 8) | 17 |\n\n---\n\n## Limitations\n\n| Out of scope | Today |\n|---|---|\n| iOS, Wear, TV, Auto, XR | Sibling plugins planned |\n| Custom backend hosting | Firebase + Supabase templates |\n| Multi-user projects | Single-user `state.json` |\n| AGP 9.x | 8.7 stable (state schema v2 shipped) |\n\n---\n\n## Contributing\n\nPRs welcome. `bash scripts/smoke.sh` must pass. Update `CHANGELOG.md` + `SPEC.md` if behavior changed.\nApache-2.0, author **Mitun only** — no `Co-authored-by`.\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md) · [`SECURITY.md`](SECURITY.md) for vulnerability reporting.\n\n---\n\n## License and author\n\n[Apache-2.0](LICENSE) · [PRIVACY.md](PRIVACY.md) · [TERMS.md](TERMS.md)\n\n**Mitun** — [github.com/mitunmanav](https://github.com/mitunmanav)\n\n<p align=\"center\"><sub><a href=\"https://github.com/mitunmanav/build-android-apps/issues\">Issues</a> · <a href=\"https://github.com/mitunmanav/build-android-apps/discussions\">Discussions</a> · <a href=\"CHANGELOG.md\">Changelog</a> · <a href=\"SPEC.md\">Spec</a></sub></p>\n",
  "bytes": 7173,
  "sha": "e2411ccbfaed52db6fa77e6063bbf473a3ce859059271124c621afea5714c68b",
  "repo_slug": "mitunmanav/build-android-apps",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mitunmanav_build_android_apps_4859576c/readme"
}