Skip to content

Commit

Permalink
Add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
batprat committed May 17, 2018
1 parent e689cc0 commit 996e856
Showing 1 changed file with 19 additions and 0 deletions.
19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# gitonbrowser

**gitonbrowser** is a Git client on your web browser. Internally it is an express application that executes git commands behind the scenes and provides UI on any browser.
One big advantage of **gitonbrowser** is that since it runs in a browser, it will provide (almost) the same experience on different OSs when used in the same browser.

## Requirements
nodejs (https://nodejs.org)

## Installation
1. clone or download the repository anywhere on your computer.
2. `cd` into the folder where you have cloned/downloaded the repository. You should be inside the folder with the `package.json` file.
3. `npm install`
4. `npm start`
5. Open http://localhost:3000 in the browser of your choice.

To use another port (e.g. 4001), `npm start 4001`.

## Common Errors
One common error at this point might be that the node app **doesn't have write access** to your git files. In this case, **open an elevated command prompt / terminal app** and try the above steps.

0 comments on commit 996e856

Please sign in to comment.