@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.