Setting Up Your Project

May 16, 2017

Once you've created a project, it's time to add some files.  Files are added through Commits or Revisions, which are essentially checkpoints for files in your project.

Cloning Your Project

To get started, clone your empty project from The Storehouse.  This creates a directory ready for your files and configures your version control program for use with The Storehouse.  To clone a project, login and navigate to the project's dashboard.  In the right column, there's a box with the URL for your project.  Copy that URL and use the command below to clone the project, replacing [PROJECT-NAME] with the directory you'd like to keep your project in and [URL] with the URL you copied.

For Git Projects:

git clone [URL] [PROJECT-NAME]

For Mercurial Projects:

hg clone [URL] [PROJECT-NAME]

For Subversion Projects:

svn co [URL] [PROJECT-NAME]

Adding Files to Your Project

Once you have some files you'd like to upload to The Storehouse, use the following command.

For Git Projects:

git add *

For Mercurial Projects:

hg add *

For Subversion Projects:

svn add *

Then, create a new commit that creates the files.

For Git Projects:

git commit -m "Initial Commit"

For Mercurial Projects:

hg commit -m "Initial Commit"

For Subversion Projects:

svn commit -m "Initial Commit"

Publishing Your Changes

For Git and Mercurial projects, you then have to transmit your new commit to The Storehouse before the files are uploaded.  For Subversion projects, this step isn't needed since your file data is uploaded when you made the commit.  To do this, issue the following commands.

For Git Projects:

git push origin master

For Mercurial Projects:

hg push