Lisk Desktop
For Contributors
Please see CONTRIBUTING.md for more information.
Development
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);
Build
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.
Electron
Start
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
Windows
Build package for Windows (on Windows in Git BASH).
npm run pack:win
macOS
Build package for macOS (on macOs)
npm run pack
Linux
Build package for Linux (on Linux).
npm run pack
Run unit tests
Single run
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 core
Setup a lisk test node as described in https://github.com/LiskHQ/lisk#tests
Run lisk test node with pm2 on localhost:4000
Run
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
Launch React Storybook
To launch storybook sandbox with components run
npm run storybook
and navigate to
http://localhost:6006/
Contributors
See contributors section.
License
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/.