meriadec
7 years ago
1 changed files with 68 additions and 30 deletions
@ -1,59 +1,97 @@ |
|||||
# Ledger Wallet Desktop |
# Ledger Live - Desktop |
||||
|
|
||||
[![CircleCI](https://circleci.com/gh/LedgerHQ/ledger-wallet-desktop.svg?style=svg)](https://circleci.com/gh/LedgerHQ/ledger-wallet-desktop) |
[![CircleCI](https://circleci.com/gh/LedgerHQ/ledger-live-desktop.svg?style=svg)](https://circleci.com/gh/LedgerHQ/ledger-live-desktop) |
||||
[![Crowdin](https://d322cqt584bo4o.cloudfront.net/ledger-wallet/localized.svg)](https://crowdin.com/project/ledger-wallet) |
[![Crowdin](https://d322cqt584bo4o.cloudfront.net/ledger-wallet/localized.svg)](https://crowdin.com/project/ledger-wallet) |
||||
|
|
||||
:warning: Disclaimer: this project is under active development. Use at your own risks. |
:warning: Disclaimer: this project is under active development. Use at your own risks. |
||||
|
|
||||
## Requirements |
## Installation |
||||
|
|
||||
* nodejs v9.x (https://nodejs.org/en/) |
#### Requirements |
||||
* yarn latest (https://yarnpkg.com/fr/docs/install) |
|
||||
|
|
||||
## Setup |
Project has been tested under [NodeJS](https://nodejs.org) v9.3.0, with [Yarn](https://yarnpkg.com) v1.3.0 and [Python](https://www.python.org/) v2.7.10 (used by [node-gyp](https://github.com/nodejs/node-gyp) to build native addons). You will also need a C++ compiler. |
||||
|
|
||||
#### Create .env file and complete it, if you want main & renderer errors to be tracked |
#### Setup |
||||
|
|
||||
``` |
1. Install dependencies |
||||
SENTRY_URL=http://... |
|
||||
DEV_TOOLS_MODE=right|bottom|undocked|detach |
|
||||
DEBUG=lwd*,-lwd:sync |
|
||||
``` |
|
||||
|
|
||||
#### Install dependencies |
```bash |
||||
|
# app dependencies |
||||
``` |
|
||||
yarn |
yarn |
||||
|
|
||||
|
# npm packages flow definitions |
||||
|
yarn flow-typed |
||||
``` |
``` |
||||
|
|
||||
## Development |
2. Create `.env` file |
||||
|
|
||||
``` |
```bash |
||||
yarn start |
# ENV VARIABLES |
||||
``` |
# ------------- |
||||
|
|
||||
## Build |
# Where errors will be tracked |
||||
|
SENTRY_URL=http://... |
||||
|
|
||||
> Not package for distribution |
# OPTIONAL ENV VARIABLES |
||||
|
# ---------------------- |
||||
|
|
||||
``` |
# Developer tools position (used only in dev) |
||||
yarn dist:dir |
# can be one of: right, bottom, undocked, detach |
||||
|
DEV_TOOLS_MODE=bottom |
||||
|
|
||||
|
# Filter debug output |
||||
|
DEBUG=lwd*,-lwd:syncb |
||||
``` |
``` |
||||
|
|
||||
> Check bundle size |
#### Development commands |
||||
|
|
||||
``` |
```bash |
||||
BUNDLE_ANALYZER=1 yarn dist:dir |
# Launch the app |
||||
``` |
yarn start |
||||
|
|
||||
> Package everything |
# Launch the storybook |
||||
|
yarn storybook |
||||
|
|
||||
|
# Code quality checks |
||||
|
yarn lint # launch eslint |
||||
|
yarn prettier # launch prettier |
||||
|
yarn flow # launch flow |
||||
|
yarn test # launch unit tests |
||||
``` |
``` |
||||
|
|
||||
|
#### Building from source |
||||
|
|
||||
|
```bash |
||||
|
# Build & package the whole app |
||||
|
# Creates a .dmg for Mac, .exe installer for Windows, or .AppImage for Linux |
||||
|
# Output files will be created in dist/ folder |
||||
yarn dist |
yarn dist |
||||
``` |
``` |
||||
|
|
||||
## Release |
**Note:** Use `yarn dist:dir` to speed up the process: it will skip the packaging step. Handy for debugging builds. You can also use `BUNDLE_ANALYZER=1 yarn dist:dir` to generate [webpack-bundle-analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer) report. |
||||
|
|
||||
|
## License |
||||
|
|
||||
``` |
``` |
||||
yarn release |
The MIT License |
||||
|
|
||||
|
Copyright (c) 2017-present Ledger https://www.ledgerwallet.com/ |
||||
|
|
||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy |
||||
|
of this software and associated documentation files (the "Software"), to deal |
||||
|
in the Software without restriction, including without limitation the rights |
||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
||||
|
copies of the Software, and to permit persons to whom the Software is |
||||
|
furnished to do so, subject to the following conditions: |
||||
|
|
||||
|
The above copyright notice and this permission notice shall be included in |
||||
|
all copies or substantial portions of the Software. |
||||
|
|
||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
||||
|
THE SOFTWARE. |
||||
``` |
``` |
||||
|
Loading…
Reference in new issue