aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFabio Berger <me@fabioberger.com>2018-10-11 04:40:14 +0800
committerFabio Berger <me@fabioberger.com>2018-10-11 04:40:14 +0800
commit19a657c38b9fbe49ad8f4605d238f113d384941a (patch)
treedc28bfb15880de93b116590d6e94c01c61ceef75
parent7418932432de53300ba276da1ca9a33fb2f1d8b1 (diff)
downloaddexon-sol-tools-19a657c38b9fbe49ad8f4605d238f113d384941a.tar.gz
dexon-sol-tools-19a657c38b9fbe49ad8f4605d238f113d384941a.tar.zst
dexon-sol-tools-19a657c38b9fbe49ad8f4605d238f113d384941a.zip
Improve README
-rw-r--r--packages/dev-tools-pages/README.md39
1 files changed, 27 insertions, 12 deletions
diff --git a/packages/dev-tools-pages/README.md b/packages/dev-tools-pages/README.md
index ce8edc103..b7bdf3bc3 100644
--- a/packages/dev-tools-pages/README.md
+++ b/packages/dev-tools-pages/README.md
@@ -2,23 +2,19 @@
This repository contains our dev tools pages.
-## Contributing
-
-We strongly recommend that the community help us make improvements and determine the future direction of the protocol. To report bugs within this package, please create an issue in this repository.
-
-Please read our [contribution guidelines](../../CONTRIBUTING.md) before getting started.
-
## Local Dev Setup
-Requires Node version 6.9.5 or higher
+Requires Node version 6.9.5 or higher & yarn v1.9.4
+
+### 1. Install dependencies for monorepo:
-### Install dependencies:
+Make sure you install Yarn v1.9.4 (npm won't work!). We rely on our `yarn.lock` file and on Yarn's support for `workspaces` in our monorepo setup.
```bash
yarn install
```
-### Initial setup
+### 2. Initial setup
To build this package and all other monorepo packages that it depends on, run the following from the monorepo root directory:
@@ -26,14 +22,19 @@ To build this package and all other monorepo packages that it depends on, run th
PKG=@0xproject/dev-tools-pages yarn build
```
-### Run dev server
+Note: Ignore the `WARNING in asset size limit` and `WARNING in entrypoint size limit` warnings.
+
+### 3. Run dev server
```bash
-PKG=@0xproject/dev-tools-pages yarn watch
+cd packages/dev-tools-pages
+yarn dev
```
Visit [http://localhost:3572/](http://localhost:3572/) in your browser.
+The webpage will refresh when source code is changed.
+
### Clean
```bash
@@ -46,14 +47,28 @@ yarn clean
yarn lint
```
+### Prettier
+
+Run from the monorepo root directory:
+
+```
+yarn prettier
+```
+
### Resources
##### Toolkit
* [Styled Components](https://www.styled-components.com/)
-* [Rebass](https://rebassjs.org/)
+* [BassCSS](http://basscss.com/)
##### Recommended Atom packages:
* [atom-typescript](https://atom.io/packages/atom-typescript)
* [linter-tslint](https://atom.io/packages/linter-tslint)
+
+## Contributing
+
+We strongly recommend that the community help us make improvements and determine the future direction of the protocol. To report bugs within this package, please create an issue in this repository.
+
+Please read our [contribution guidelines](../../CONTRIBUTING.md) before getting started.