2020-09-02 15:17:26 -04:00
|
|
|
# HedgeDoc - React Client
|
2020-05-14 09:41:38 -04:00
|
|
|
|
2020-08-04 15:29:17 -04:00
|
|
|
|
2020-07-16 05:22:53 -04:00
|
|
|
|
|
|
|
|
|
2020-09-02 15:17:26 -04:00
|
|
|
This is the new, improved and better looking frontend for HedgeDoc 2.0.
|
2020-05-14 09:41:38 -04:00
|
|
|
Our goal is to recreate the current frontend in react and to improve it.
|
|
|
|
|
|
2020-06-06 17:58:45 -04:00
|
|
|
## Preparation
|
2020-08-27 08:34:10 -04:00
|
|
|
You'll need at least Node 12. We use [yarn](https://yarnpkg.com/) for our dependencies.
|
2020-05-14 09:41:38 -04:00
|
|
|
|
2020-06-06 17:58:45 -04:00
|
|
|
## Development mode
|
2020-05-14 09:41:38 -04:00
|
|
|
|
2020-09-02 15:17:26 -04:00
|
|
|
1. Clone this repo (e.g. `git clone https://github.com/codimd/react-client.git hedgedoc-react-client`)
|
|
|
|
|
2. Go inside the repo (e.g. `cd hedgedoc-react-client`)
|
2020-08-04 15:29:17 -04:00
|
|
|
3. Run `yarn install`
|
2020-07-29 16:58:01 -04:00
|
|
|
4. Either run
|
|
|
|
|
- `yarn start:dev` (expects [a server](https://github.com/codimd/server/tree/develop) running under [http://localhost:3000](http://localhost:3000))
|
|
|
|
|
- `yarn start` (makes all api calls to the same domain the react-client runs on (normally [http://localhost:3001](http://localhost:3001) ))
|
2020-05-14 09:41:38 -04:00
|
|
|
|
2020-07-29 16:58:01 -04:00
|
|
|
This should run the app in the development mode and open [http://localhost:3001](http://localhost:3001) in your browser.
|
2020-05-14 09:41:38 -04:00
|
|
|
|
|
|
|
|
The page will reload if you make edits.
|
|
|
|
|
You will also see any lint errors in the console.
|
|
|
|
|
|
2020-07-16 05:22:53 -04:00
|
|
|
### Tests
|
|
|
|
|
|
2020-07-16 05:34:56 -04:00
|
|
|
#### Unit
|
|
|
|
|
|
|
|
|
|
Unit testing is done via jest.
|
|
|
|
|
|
2020-08-04 15:29:17 -04:00
|
|
|
1. Run `yarn test`
|
2020-07-16 05:34:56 -04:00
|
|
|
|
2020-07-16 05:22:53 -04:00
|
|
|
#### End2End
|
|
|
|
|
|
|
|
|
|
We use [cypress](https://cypress.io) for e2e tests.
|
|
|
|
|
|
2020-08-04 15:29:17 -04:00
|
|
|
1. Start the frontend with `yarn start`
|
|
|
|
|
2. Run `yarn cy:open` to open the cypress test loader
|
2020-07-16 05:22:53 -04:00
|
|
|
3. Choose your browser and test
|
|
|
|
|
4. Let the tests run
|
|
|
|
|
|
2020-05-14 09:41:38 -04:00
|
|
|
## Production mode
|
|
|
|
|
|
2020-09-02 15:17:26 -04:00
|
|
|
1. Clone this repo (e.g. `git clone https://github.com/codimd/react-client.git hedgedoc-react-client`)
|
|
|
|
|
2. Go inside the repo (e.g. `cd hedgedoc-react-client`)
|
2020-08-04 15:29:17 -04:00
|
|
|
3. Run `yarn install`
|
|
|
|
|
4. Run `yarn build`
|
2020-05-14 09:41:38 -04:00
|
|
|
|
|
|
|
|
Builds the app for production to the `build` folder.
|
|
|
|
|
It correctly bundles React in production mode and optimizes the build for the best performance.
|
|
|
|
|
|
2020-08-04 15:29:17 -04:00
|
|
|
The build is minified and the filenames include a hash value of the content.
|
