Please see CONTRIBUTING.md for more information.
git clone https://github.com/LiskHQ/lisk-desktop.git cd lisk-desktop npm install npm run dev
For ease of development, you can set the following query string to see network options in login page:
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
Using Commercial Fonts
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
Run unit tests
npm run test
Run each time a file changes
npm run test-live
Run end-to-end tests
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
Start the development version of Lisk:
npm run dev
Apply blockchain snapshot
~/git/lisk/ with your path to lisk core)
Run e2e tests
npm run cypress:run
Launch React Storybook
To launch storybook sandbox with components run
npm run storybook
and navigate to
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.