Please see CONTRIBUTING.md for more information.

git clone https://github.com/LiskHQ/lisk-desktop.git
cd lisk-desktop
npm install
npm run dev

Open http://localhost:8080

For ease of development, you can set the following query string to see network options in login page:

http://localhost:8080/#/?showNetwork=true

If you are actively developing in a specific route, and want to be autologged in everytime you reload the page, please add the following to localStorage:

localStorage.setItem('liskCoreUrl', 'http://localhost:4000') // desired node to log in into
localStorage.setItem('loginKey', 'wagon stock borrow episode laundry kitten salute link globe zero feed marble') // desired account passphrase

When developing with hardware wallet, this will log you into to first account on the first connected hardware wallet:

localStorage.setItem('liskCoreUrl', 'http://localhost:4000') // desired node to log in into
localStorage.setItem('hwWalletAutoLogin', true);

npm run build

Since some of the fonts used in the production version are commercial, this repository only contains open source fonts and uses Open Sans as a replacement for the commercial ones.

If you have licensed copies of Basier Circle and Gilroy, you can add them to fonts folder to replace the empty files that are there so that webpack build doesn't fail if the fonts are not present.

Start the Electron client. Before staring you need to make sure the application is built. If you need to build the entire application, run

npm run build

as mentioned before. And if you want to solely build electron app, run

npm run build-electron

Then, in order to launch electron, you can run

npm run start

Then, in order to launch version with hardware wallet, you can run

npm run dev-hardware-wallet

In order to launch electron that gets live updates from already running webpack-dev-server on port 8080 and with react/redux dev tools, you can run

LISK_HUB_URL="http://localhost:8080" DEBUG=true npm run start

Build package for Windows (on Windows in Git BASH).

npm run pack:win

Build package for macOS (on macOs)

npm run pack 

Build package for Linux (on Linux).

npm run pack 

npm run test

npm run test-live

In order to run e2e tests you need to install lisk-core

Setup a lisk test node as described in https://github.com/LiskHQ/lisk#tests

Run lisk test node with pm2 on localhost:4000

Start the development version of Lisk:

npm run dev

Apply blockchain snapshot

./test/e2e-test-setup.sh ~/git/lisk/

(replace ~/git/lisk/ with your path to lisk core)

Run e2e tests

npm run cypress:run

To launch storybook sandbox with components run

npm run storybook

and navigate to

http://localhost:6006/

See contributors section.

Copyright © 2016-2018 Lisk Foundation

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.