Skip to content
David Richardson edited this page Aug 7, 2019 · 22 revisions

Description

capp is a simple command line tool for initial creation of Cappuccino applications. A number of pre-defined templates (described in more detail below) are available. Cappuccino (web browser) and Objective-J (command line) applications can be run from the project directory as-is but a basic Jakefile is provided which defines jake tasks which generate compiled and otherwise optimized versions of the application.

Usage

capp [—version] COMMAND [ARGS]

capp gen PATH [options]

Create a new Cappuccino project at PATH

Options

  • -l By default, a set of the latest Cappuccino frameworks are to the Frameworks directory of the project at the specified path. Running the command with the -l flag creates a set of symbolic links to the core frameworks built from source (ie. your $CAPP_BUILD or $STEAM_BUILD directory).
  • -t, —template Specify what project template to use. By default the Application template is chosen. Currently the following templates exist:
    • Application – An empty application with an application controller class.
    • ThemeDescriptor – A special project for creating custom Cappuccino themes.
    • NibApplication – An empty application much like that one created in Application, but with the UI in .xib that can be converted to a cib with nib2cib
  • -f, —frameworks Just create the frameworks folder and don’t continue to making an actual project. You can use this with the -l flag to just create a set of symbolic links to the built frameworks from source.
  • —force Overwrite Frameworks directory if it already exists
  • —symlink Create a symlink to the source Frameworks
  • —build Source the Frameworks directory files from your $CAPP_BUILD or $STEAM_BUILD directory

capp config name value

This will configure capp with your information.

Options

  • —get name Shows the value of a key
  • -l, —list Lists all the current keys

Possible keys

  • user.name
  • user.email
  • organization.name (e.g. “The Cappuccino Project”)
  • organization.url (e.g. “http://cappuccino.dev”)
  • organization.email (e.g. “noreply@cappuccino.dev”)
  • organization.identifier this is a reverse domain identifier (e.g. dev.cappuccino for an app published by http://cappuccino.dev)

Examples

capp config user.name "Francisco Tolmasky"
Now all my new projects will say “Created by Francisco Tolmasky”.

capp config organization.identifier "com.280n"
So if I create the project “MyGreatApp”, its identifier becomes “com.280n.MyGreatApp”.