geeknative CLI
A project template and CLI that lets a coding agent build one app natively for iOS, Android and the web from a shared spec.
- 69 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The agent generates and edits code for three apps and runs builds through `make`.
- `FIX=1 make doctor` installs missing components on the machine.
Install
- Works in
Manual install
npm create geeknative@latest my-app -- --name "My App" --id com.acme.myappCreates the project. Then `make doctor` checks the environment and `make check` builds and tests the three apps.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent generates and edits code for three apps and runs builds through `make`.
- `FIX=1 make doctor` installs missing components on the machine.
This is third-party code. Review the repository files before installing.
What it does
geeknative scaffolds a project with `npm create geeknative@latest` in which an agent builds the same app in SwiftUI, Kotlin with Jetpack Compose and React with TanStack Start. The apps share no code; three layers keep them consistent: `PRODUCT.md`, `DESIGN.md` and feature specs, contracts in `contracts/` (colors, copy, icons, app identity) and identical architecture with identical names. `AGENTS.md` teaches the agent to classify a request, update the source of truth first, implement the change on all platforms and verify with `make check`. `make parity` shows which acceptance criteria each platform covers in tests. Claude Code gets ios-engineer, android-engineer and web-engineer subagents plus hooks that regenerate code when contracts change.
Who it is for. Mobile and web developers shipping one app on three platforms who want an agent to implement it without a cross-platform runtime.
Good fit when
- A new product is needed on iOS, Android and web with unified design and behavior.
- An agent needs a shared source of truth so platforms do not drift.
- A color or copy change must flow into Swift, Kotlin and TypeScript automatically.
- You need a report of which acceptance criteria each platform covers in tests.
Not a fit when
- You want a single cross-platform codebase in Flutter or React Native.
- The app needs a ready backend: the template has none and uses local repository implementations.
- Xcode or the Android SDK is not available on the machine.
Example request
Add a notes list screen to all three apps and show which acceptance criteria are covered by tests.Limitations
Building needs Xcode, the Android SDK, Java and Node; `make doctor` checks them and `FIX=1 make doctor` installs what is missing. Minimums: iOS 17, Android 7.0 (API 24), Safari 16.4, Chrome 111, Firefox 128. The template has no backend. The agent builds three apps at once, so changes take noticeably longer than on one platform and spend more tokens. Native iOS builds can be verified only on macOS with Xcode. Template data is local, with no backend calls until you add them.
How to disable. Delete the generated project. Framework files live in `.geeknative/`; the `geeknative:begin/end` blocks in `AGENTS.md` and `CLAUDE.md` and the `.claude/agents/` directory are replaced on upgrade.
FAQ
Which agents work with it?
Any agent that reads `AGENTS.md`: Claude Code, Codex, Cursor, Gemini CLI. Claude Code additionally gets three subagents and hooks.
How do the apps stay consistent without shared code?
Through an agent-readable source of truth, contracts in `contracts/` that `make gen` turns into code for every platform, and identical architecture.
What does `make check` do?
It builds and tests all three apps: SwiftUI, Jetpack Compose and the TanStack Start web app.
Which platforms and technologies are in the template?
iOS in SwiftUI, Android in Kotlin and Jetpack Compose, web in React 19 with TanStack Start and Tailwind CSS v4.
What does `make parity` do?
It maps criteria from feature specs to IDs in tests and prints a per-platform summary.
Discussion
No questions or reviews yet.
Related
CLI toolsAn Android skill covering modular architecture, Compose, Material 3, accessibility and Kotlin migrations.
A set of skills, agents and commands for iOS, iPadOS, watchOS and tvOS development: Swift 6, SwiftUI, Liquid Glass and Apple Intelligence
Awesome Android Agent Skills
awesome-android-agent-skills
Skills for modern Android development for Copilot, Claude, Gemini and Cursor: Kotlin, Jetpack Compose, architecture, Hilt, Room
Gives an agent control of iOS simulators, Android emulators, TVs and Electron apps: taps, flows, profiling and React Native debugging
Official set of 30 skills from the Android team: Jetpack Compose, AGP 9 upgrade, R8, Perfetto profiling, Navigation 3, CameraX, Google Play policies
A Claude Code skill that designs and builds a questionnaire-style app onboarding flow modeled on subscription apps
README in short
The template generates a project with three apps, product and design documents, contracts and agent instructions. A demo wedding planner app and a documentation site are included.