CLI Reference

$ npx create-target widget

Creating a widget Apple target.

Installing @bacons/apple-targets package...

added 1 package in 3s

Writing expo-target.config.js file
Writing Info.plist file
Target created! Run npx expo prebuild -p ios to fully generate the target. Develop native code in Xcode.

$ npx create-target --version
3.0.4

$ npx create-target --help

Info
  Creates a new Expo Apple target

Usage
  $ npx create-target <target> [options]

Options
  --no-install      Skip installing npm packages
  -v, --version     Version number
  -h, --help        Usage info

  The package manager used for installing
  node modules is based on how you invoke the CLI:

   npm: npx create-target
  yarn: yarn create target
  pnpm: pnpm create target
   bun: bun create target

$ npx create-target

? Choose a target: (Use arrow keys)
❯ Widget - Home screen widget
  App Clip - Instantly open your app without installing
  Action - Headless action that appears in share sheets
  Account Auth
  App Intent
  Background Download
  Broadcast Upload
  Call Directory
  Content Blocker - Safari content blocker extension
  Credentials Provider
  Device Activity Monitor
  File Provider
  Keyboard Extension - Custom system keyboard
  Location Push
  (Move up and down to reveal more choices)

$ npx create-target widget

Creating a widget Apple target.

? Target directory /path/to/project/targets/widget is not empty. Continue? (Y/n)

/** @type {import('@bacons/apple-targets/app.plugin').ConfigFunction} */
module.exports = config => ({
  type: "widget",
  icon: './assets/widget-icon.png',
  colors: {
    $accent: 'steelblue',
  },
  entitlements: {
    'com.apple.security.application-groups': [
      `group.${config.ios.bundleIdentifier}.widget`
    ],
  },
});

» Removing ios
› Creating native directories (./ios)
› Updating ios/MyApp.xcodeproj
› Adding target widget
› Configuring entitlements
› Installing CocoaPods dependencies

Successfully generated native projects.

name: Build iOS
on: [push]

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup Node
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      
      - name: Install dependencies
        run: npm install
      
      - name: Create widget target
        run: npx create-target widget
      
      - name: Prebuild iOS
        run: npx expo prebuild -p ios --clean
      
      - name: Build app
        run: |
          cd ios
          xcodebuild -workspace MyApp.xcworkspace \
            -scheme MyApp \
            -configuration Release

  expo:create-target Default args:
  expo:create-target { '--no-install': false, _: [ 'widget' ] }
  expo:create-target Parsed:
  expo:create-target { projectRoot: 'widget', args: {} }

Creating a widget Apple target.

Installing @bacons/apple-targets package...
# ...