2020-03-25 19:52:18 -07:00
## ZEPIO IS NO LONGER ACTIVELY MAINTAINED
*We will be archiving this repo soon. If you would like a shielded-first desktop wallet, we recommend [ZecWallet ](https://www.zecwallet.co/ ).*
2018-11-23 10:41:50 -08:00
2019-04-28 19:50:12 -07:00
Zepio is a Sapling-enabled shielded-address-first Zcash wallet, featuring cross-platform applications (macOS, Windows and Linux), built-in full node with support for `mainnet` and `testnet` , as well as `dark` and `light` themes.
2018-11-23 10:41:50 -08:00
2019-04-28 19:59:47 -07:00
![Build Status ](https://app.bitrise.io/app/a5bc7a8391d5501b/status.svg?token=SOuGNc3Qf9rCj3Osl-eHyQ&branch=master )
2019-04-10 07:15:33 -07:00
![Flow Coverage ](./public/flow-coverage-badge.svg )
2019-01-29 15:12:03 -08:00
2019-04-28 19:50:12 -07:00
### [Latest Documentation](https://zepiowallet.com)
2019-04-16 20:23:02 -07:00
2019-04-28 19:50:12 -07:00
### [Latest Release](https://github.com/ZcashFoundation/zepio/releases)
2019-04-27 15:36:18 -07:00
2019-04-28 19:50:12 -07:00
![Zepio Wallet ](https://raw.githubusercontent.com/ZcashFoundation/zepio-docs/develop/docz/assets/dashboard.png )
2019-04-16 20:23:02 -07:00
2018-11-23 10:41:50 -08:00
## Stack Information
2019-04-28 19:50:12 -07:00
List of the main open source libraries and technologies used in building **Zepio** :
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
- [zcashd ](https://github.com/zcash/zcash ): Zcash node daemon
- [Electron ](https://github.com/electron/electron ): Desktop application builder
- [React ](https://facebook.github.io/react/ ): User interface view layer
2019-05-29 16:23:04 -07:00
- [Redux ](https://redux.js.org/ ): Predictable application state container
2019-04-28 19:50:12 -07:00
- [Styled Components ](https://www.styled-components.com/ ): Visual primitives for theming and styling applications
2019-05-29 16:23:04 -07:00
- [webpack ](https://webpack.github.io/ ): Application module bundler (and more)
- [Babel ](https://babeljs.io/ ): ES7/JSX transpilling
- [ESLint ](https://eslint.org/ ): Code linting rules
2019-04-28 19:50:12 -07:00
- [Flow ](https://flow.org ): JavaScript static type checker
- [Docz ](https://docz.site ): Documentation builder
2019-05-30 09:58:55 -07:00
- [BigNumber.js ](https://github.com/MikeMcl/bignumber.js#readme ): Arbitrary-precision decimal and non-decimal arithmetic with safety
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
## Installing and Running From Source
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
To run **Zepio** from source you'll need to perform the following steps:
```bash
# Ensure you have Node LTS v8+
# https://nodejs.org/en/
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Clone Codebase
git clone git@github.com:ZcashFoundation/zepio.git
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Install Dependencies
# inside of the `zepio` folder
yarn install
# or
npm install
# Start Application
# webpack development server hosts the application on port
# 8080 and launches the Electron wrapper, which also hosts
# the `zcashd` node daemon process.
yarn start
# or
npm start
```
## Building Application Locally
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
To build the application locally follow the instructions below:
```bash
# Make sure you are inside of the main `zepio` folder
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Run Build Script
yarn electron:distall
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Executables and binaries available under `/dist` folder
```
2018-11-23 10:41:50 -08:00
2019-04-28 19:59:47 -07:00
## Flow Coverage (Static Type Checker)
2018-11-23 10:41:50 -08:00
2019-04-28 19:50:12 -07:00
For a deeper look on the static typing coverage of the application, please follow below:
2018-11-23 10:41:50 -08:00
```bash
2019-04-28 19:50:12 -07:00
# Make sure you are inside of the main `zepio` folder
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Generate Flow Coverage Report
# this can take a couple seconds
yarn flow:report
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Browser should open with the file `index.html` opened
# Files are also available at `zepio/flow-coverage/source`
2018-11-23 10:41:50 -08:00
```
2019-04-28 19:50:12 -07:00
## Component Library (Docz)
2018-11-23 10:41:50 -08:00
2019-04-28 19:50:12 -07:00
To see Zepio's React component library, please visit https://zepio-components.now.sh. We're always looking for folks to help keep the styleguide updated.
2018-11-23 10:41:50 -08:00
2019-04-28 19:50:12 -07:00
To run the component library locally, run the following:
2018-11-23 10:41:50 -08:00
```bash
2019-04-28 19:50:12 -07:00
# Make sure you are inside of the main `zepio` folder
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Run Docz Development Script
yarn docz:dev
2019-04-10 07:15:33 -07:00
2019-04-28 19:50:12 -07:00
# Visit http://127.0.0.1:4000/
2018-11-23 10:41:50 -08:00
```
2019-04-28 19:50:12 -07:00
To build the component library locally, run the following:
```bash
# Make sure you are inside of the main `zepio` folder
# Run Build Script
yarn docz:build
# Check `/.docz/dist` folder for built static assets
```
## Tests
To run the application's tests, please run the below:
```bash
# Make sure you are inside of the main `zepio` folder
# For Unit Tests: Run Jest Unit Test Suite
yarn test:unit
# For E2E (end-to-end) Tests: Run Jest E2E Suite
yarn e2e:serve
# on another terminal window
yarn test e2e
```
## Contributing
In order to contribute and submit PRs to improve the **Zepio** codebase, please check our [CONTRIBUTING ](https://github.com/ZcashFoundation/zepio/blob/master/CONTRIBUTING.md ) guide.
2018-11-30 08:13:18 -08:00
2018-11-23 10:41:50 -08:00
## License
2019-06-17 10:41:20 -07:00
MIT © Zcash Foundation 2019 [zfnd.org ](https://zfnd.org )