README.md

Webtrader

Webtrader.binary.com - The goal of this project is to create a full-screen trading interface for Binary.com according to the following design:

In this document:

• Pre-installation
• Quick start
• How to contribute
• Manage translations
• Test link deployment

Pre-installation

Before running or contribute to this project, you need to have the setup of the following packages in your environment:

• node >=12.3.0
• npm
• git

Quick start

1. Fork the project

   In order to work on your own version, please fork the project to your own repo.

2. Clone using SSH

   git clone [email protected]:your-github-username/webtrader.git

3. Enter project directory

   cd webtrader

4. Install your dependencies:

   npm install
   npm run build

5. Start developing:

   npm start

6. Open the source code and start editing!

   Your site is now running at http://localhost:9001!

Note*: Since backend needs an https web address for oauth app register if you intend to debug oauth login on localhost, you need to modify your /etc/hosts file. For example the https://webtrader.local/ token in src/oauth/app_id.josn is registered to https://webtrader.local/ address, you need to do the following in order to use it locally.

Add this line to your /etc/hosts file.

    127.0.0.1 webtrader.local

Use this command to run your local server on https.

    $ sudo node_modules/.bin/grunt connect:https

Use this command to watch the files.

    $ node_modules/.bin/grunt && node_modules/.bin/grunt watch:https

Go to https://webtrader.local:35729 and accept the self signed ssl certificate for grunt livereload.

Now you can debug your app on https://webtrader.local/ locally.

To bump release version, run

    $ npm major-rel
    or
    $ npm minor-rel
    or
    $ npm patch-rel

Every check-in or merge into master will trigger travis-ci build and do a release to production.

Every check-in or merge of PR into development will trigger travis-ci build and do a beta release

How to contribute

In order to contribute, please fork and submit pull request by following all the following mentioned coding rules:

1. Clone using SSH

   $ git clone [email protected]:your-github-username/webtrader.git
   

2. Create branch from latest master branch

   ```sh
   git checkout master
   git pull upstream master
   git checkout -b [_your_branch_name]
   ```
   

3. MAKE YOUR CHANGES

4. Make pull request

• Push your changes to your origin

  ```sh
  git push -u origin [_your_branch_name]
  ```
  

• Click on the autogenerated link from terminal to open the PR

Manage translations

Translation related files are in /translations folder.

To extract text for translation:

    ```sh
    $ npm run build
    $ cd ./translations
    $ python extract.py
    $ extract.py # extracts string literals from `dist/uncompressed` (from *.html and *.js)
    $ extract.py # for merging `.po` files uses `msgmerge` command line tool.
    ```

Note*: The tool should be available on linux, if you are on Osx try brew install gettext && brew link gettext --force.

Note*: To submit text to translators: push to translation branch, weblate hook will be triggered.

Note*: To see CrowdIn In-Context translations pass querystring ?lang=ach (obs not for production env)

Test link deployment

While submitting your PR, make sure that you deploy your code to your forked gh-pages by running following command, so that the reviewer can have a look at the deployed code at this url $username.github.io/webtrader/branch-name:

    ```sh
    $ grunt deploy-branch
    ```