Parra logo

Parra CLI Usage

This guide offers a detailed overview of the commands available in the Parra CLI. If you haven't installed it yet, be sure to check out the installation or getting started guide.

parra bootstrap

The bootstrap command is used to generate a new Xcode project for your Parra app. To do this, it performs the following operations:

  1. Prompt you to open a link in your browser to authenticate with Parra. This has the same effect as running parra login. If you're already logged into, you will not be prompted to login again until your session expires.
  2. Guide you through selecting an existing Parra workspace and application in the dashboard or creating new ones. It is best to sign up for your Parra account and configure your workspace and application in the dashboard, but it isn't a requirement before running this command.
  3. Install any missing dependencies.
  4. Generate a pre-configured Xcode project.

Generally, bootstrapping a new project looks like this:

A terminal screenshot displaying the execution of the parra bootstrap command.

Available Command Line Arguments

Optionally, you can specify the following arguments to the bootstrap command to avoid being prompted for them:

  • Name
    -a, --application-id
    Description

    The identifier of the application you want to bootstrap. You can find this value on the Applications screen in the Parra dashboard. If you pass this arg, you will not be prompted to provide an application ID.

  • Name
    -t, --tenant-id
    Description

    The identifier of the tenant that owns your application in the Parra dashboard. You can find this value on the Settings screen in the Parra dashboard. If you pass this arg, you will not be prompted to provide an tenant ID.

  • Name
    -p, --project-path
    Description

    The path where the new project should be created. If you pass this arg, you will not be prompted to provide a project path.

  • Name
    --template
    Description

    The name of the template that you want to use when generating your new app. By default, the default template is used. For a list of available templates, check out the templates page.

parra login

If you aren't already logged in, running this command will prompt you to open your browser and log into your Parra account. A one-time-code will be provided that must be entered in the browser after logging in to authenticate you. By default, this code will be pre-filled in the browser but is available to you in your shell to enter manually if necessary. Once you finish authenticating in your browser, return to your terminal. A session token will be stored in the system keychain parra_cli.

parra logout

Removes your Parra session token from the system keychain parra_cli.

Was this page helpful?