aide-cli
v0.0.3
Published
Advanced build & deployment CLI for AIDE applications. Replaces bash build script with interactive TUI, multi-region, multi-environment support, automatic VERSION_CODE increment.
Readme
AIDE Build CLI
Advanced build & deployment CLI for AIDE applications. Replaces bash build script with interactive TUI, multi-region, multi-environment support, automatic VERSION_CODE increment.
Quick Start
Interactive mode:
bun run aide-cliArrow keys → select options → show config → execute.
Macro mode (shortcuts):
bun run aide-cli ca dev apk local # Canada, dev, APK, local build
bun run aide-cli in prod aab config # India, prod, AAB, show config
bun run aide-cli all prod local-clean # Both regions, prod, clean build
bun run aide-cli ca release local # Canada, release (auto AAB + VERSION_CODE++)Aliases:
bun run dev→ same asbun run aide-clibun run aide-cli→ entry point (recommended)
Project Structure
src/
├── cli.ts # Entry point (main loop)
├── types.ts # Type definitions (Region, Environment, BuildConfig)
├── config/
│ ├── index.ts # Constants (defaults, paths, keystore)
│ ├── regions.ts # Region configs (CA/IN packages, EAS projects)
│ └── environments.ts # Env configs (dev/prod/release channels)
├── ui/
│ └── menu.ts # TUI prompts (@clack/prompts)
├── commands/
│ ├── build.ts # APK/AAB build, keystore, VERSION_CODE
│ ├── eas.ts # EAS build/update/submit (TODO)
│ ├── device.ts # ADB tools (TODO)
│ ├── version.ts # Versioning utilities
│ ├── clean.ts # Cache/build cleanup
│ └── config.ts # Config summary display
└── utils/
├── parser.ts # Macro arg parser
└── version.ts # Read/write/increment app.config.ts VERSION_CODEShortcuts
Regions: ca | in | all
Environments: dev | prod | release
Build Types: apk | aab
Commands: local | local-clean | eas | device | version | clean | config
Features
✅ Interactive menu (arrow keys, no typing)
✅ Macro shortcuts (e.g., ca dev apk local)
✅ Config summary display
✅ Release builds: Auto-increment VERSION_CODE, force AAB (no APK)
✅ Keystore generation (skip in dev mode)
✅ Local build options: local (prebuild) | local-clean (clean prebuild)
✅ Clean modular structure
✅ Full test coverage (parser, version utils)
🔄 TODO: Full EAS/device/version commands
Release Builds
Release environment automatically:
- Increments
VERSION_CODEinapp.config.ts - Forces AAB output (no APK option)
- Example:
bun run dev in release local→ increments code → builds India AAB
Customize
Edit src/config/regions.ts and src/config/environments.ts to adjust:
- Region package names, EAS projects
- Environment channels, app env vars
- Build roots, keystore paths
