stork-cli v0.0.2
#Stork CLI
CLI for interacting with the stork service
Get started with cordova or ionic
Get started with a raw iOS application
# Install
npm install stork-cli
# User related commands
stork login -u USERNAME -p PASSWORD
stork logout
stork me
# Project commands
stork init
stork project:list
stork project:create
stork project:info
stork project:link
stork deploy
##Getting Started ###Cordova Based Applications (ionic, phone gap, etc) In order to use Stork for your Cordova application, you have to install a few plugins and some configuration values. If you need help getting a basic cordova project created, head over to their docs.
####Step 1 - Install the cli
$ npm install stork-cli
###Step 2 - Log into your Stork account
$ stork login
Email: user@email.com
Password (typing will be hidden):
Logged in as Stork User <user@email.com>
###Step 3 - Install the cordova plugin
cordova plugin add https://github.com/StorkHQ/stork-cordova.git
###Step 4 - Create your project
You will need to choose a name for your project and tell
Stork where your web code lives. To do this, you will need to include
the -d ./www
option when creating the projct. This tells Stork
that your code lives in the www
directory.
stork project:create "Awesome Project" -d ./www
###Step 5 - Set up your info.plist file
Open your xcodeproj with xcode and navigate to the Info section of
your project settings. Right click one of the Custom iOS Target Properties
and select "Add Row". In the new row, set the key to StorkProjectToken and
set the value to the token returned by the stork project:create
command.
###Step 6 - Deploy The last step necessary is to deploy your web code to Stork. To do this, simply do the following:
stork deploy
This will push the current code in your ./www directory out to any phones that have the app installed.
##Standard iOS Applications
Use this tutorial to get a project set up that is raw iOS code with a web view.
####Step 1 - Install the cli
$ npm install stork-cli
###Step 2 - Log into your stork account
$ stork login
Email: user@email.com
Password (typing will be hidden):
Logged in as Stork User <user@email.com>
###Step 3 - Add Stork to your podfile
pod 'Stork', :git => 'https://github.com/StorkHQ/stork-ios.git'
###Step 4 - Create your project
You will need to choose a name for your project and tell
Stork where your web code lives. To do this, you will need to include
the -d
option. You should provide a path relative to the root project
directory to where the web code exists. This directory should have all of your
web code and have an index.html
in its root.
stork project:create "Awesome Project" -d ./www
###Step 5 - Add Stork init code to your web view
Add the following code to your web view controller, "your-project-token"
should
be the token returned by the $ stork project:create
command from step 4.
- (void)viewDidLoad
{
[super viewDidLoad];
// Initialize binds - configure Stork (default version will be 0.0.0)
[[Stork sharedClient] bindWithProjectToken:@"your-project-token" withVersion:@"your-project-version"];
[[Stork sharedClient] bindWithWebView:self.webView];
// Start Stork - Stork now handles downloads and updates
[[Stork sharedClient] start];
}
for more info on this SDK, see https://github.com/StorkHQ/stork-ios
###Step 6 - Deploy Once you have the new iOS code installed on a phone, you just have to call
stork deploy
to get the latest web code onto your device.
##Login Will log you in with the stork API and store your session for future commands. This is a pre-requisite for most other commands.
--username or -u
email address used on storkhq.io--password or -p
password used on storkhq.io
$ stork login -u nick@computer.org -p hunter2
Logged in as email@computer.org
$ stork login
Please enter your stork credentials.
Email: email@computer.org
Password (typing will be hidden):
Logged in as Stork User <email@computer.org>
##Me Requires Authentication
Will display the email address of the user currently logged in.
$ stork me
email@computer.org
##Projects Requires Authentication
###project:list Will display the list of all of the active projects for the currently logged in user.
$ stork project:list
###init (alias - project:init
)
Will create a new project in the current directory. If a slug is provided for an existing project, it will link this local directory to the remote project
name
the human readable name of the project - this is a positional argument *required--slug or -s
the unique identifier for this project (e.g. project_name)--directory or -d
the local directory where the web code for this project lives (defaults to./
)
$ stork init "New project name" -s awesome-project -d ./www
###project:create Will create a new project in the current directory.
name
the human readable name of the project - this is a positional argument *required--slug or -s
the unique identifier for this project (e.g. project_name)--directory or -d
the local directory where the web code for this project lives (defaults to./
)
$ stork project:create "Awesome Project" -s awesome-project
###project:info
Display detailed information about the project linked to the current
directory, or to the project identified by --project
--project or -p
the unique identifier for this project (e.g. project_name)
$ stork project:info -p awesome-project
###project:link
Will create link this local directory to the remote project identified by --project
--project or -p
the unique identifier for this project (e.g. project_name) *required
$ stork project:link -p awesome-project
##Deploy Requires Authentication
Will deploy the current project to stork on the current version.
$ stork deploy
/ Deploying... Deployed!
0w909uwt0349ut029t0293u50293u5