@codewithbeto/ship

CLI tool for scaffolding Code with Beto templates.

Requirements

Before running ship, make sure you have the following installed:

• Git — for cloning templates
• GitHub CLI (gh) — for authenticating and accessing private templates
  • macOS: brew install gh
  • After install, run gh auth login to authenticate

Note: Templates are private repositories. You must be a Pro Member and have gh installed and authenticated.

Interactive (humans)

bunx @codewithbeto/ship

Templates

• Platano — React Native starter

Development

bun install
bun dev

Non-interactive (AI agents)

AI agents: See AGENTS.md for a concise reference.

Pass flags to skip the TUI entirely. Every input is a flag, output is structured text, and errors fail fast with actionable messages.

# Scaffold with defaults
ship --name my-app

# Full configuration
ship --name my-app --app-name "Cool App" --bundle-id com.me.coolapp --no-payments

# Preview without making changes
ship --name my-app --dry-run

# See all options
ship --help

Key flags:

Flag	Description	Default
--name <dir>	Project directory (required)	—
--template <name>	Template to use	platano
--app-name <name>	Display name for app stores	title-cased --name
--bundle-id <id>	Bundle identifier	com.<user>.<slug>
--payments / --no-payments	Enable RevenueCat	--payments
--rc-key-ios <key>	RevenueCat test key (iOS)	—
--rc-key-android <key>	RevenueCat test key (Android)	same as iOS
--dry-run	Preview without side effects	—

Progress logs go to stderr, the final result goes to stdout.

Code with Beto

These packages are part of the Code with Beto ecosystem. If you're into React Native, check us out:

• Pro Membership - Courses, private repos, Discord community, and direct access to the team
• YouTube - Free tutorials and content

---

Built with OpenTUI.