2018-03-20 17:33:51 +00:00
|
|
|
# Quick Start
|
|
|
|
|
|
2021-06-20 00:12:59 +00:00
|
|
|
- Install mitmproxy as described in [`../CONTRIBUTING.md`](../CONTRIBUTING.md)
|
|
|
|
|
- Run `node --version` to make sure that you have at least Node.js 14 or above. If you are on **Ubuntu <= 20.04**, you
|
|
|
|
|
need to
|
|
|
|
|
[upgrade](https://github.com/nodesource/distributions/blob/master/README.md#installation-instructions).
|
|
|
|
|
- Run `npm install` to install dependencies
|
|
|
|
|
- Run `npm start` to start live-compilation
|
|
|
|
|
- Run `mitmweb` after activating your Python virtualenv (see [`../CONTRIBUTING.md`](../CONTRIBUTING.md)).
|
2020-05-18 18:21:23 +00:00
|
|
|
|
2021-03-30 10:12:38 +00:00
|
|
|
## Testing
|
|
|
|
|
|
2021-06-20 00:12:59 +00:00
|
|
|
- Run `npm test` to run the test suite.
|
2021-06-10 12:59:30 +00:00
|
|
|
|
2020-05-18 18:21:23 +00:00
|
|
|
## Architecture
|
|
|
|
|
|
|
|
|
|
There are two components:
|
|
|
|
|
|
|
|
|
|
- Server: [`mitmproxy/tools/web`](../mitmproxy/tools/web)
|
|
|
|
|
|
|
|
|
|
- Client: `web`
|
2021-06-20 00:12:59 +00:00
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
|
|
We very much appreciate any (small) improvements to mitmweb. Please do *not* include the compiled assets in
|
|
|
|
|
[`mitmproxy/tools/web/static`](https://github.com/mitmproxy/mitmproxy/tree/main/mitmproxy/tools/web/static)
|
|
|
|
|
in your pull request. Refreshing them on every commit would massively increase repository size. We will update these
|
|
|
|
|
files before every release.
|
|
|
|
|
|
|
|
|
|
## Developer Tools
|
|
|
|
|
|
|
|
|
|
- `npm start` supports live-reloading if you install a matching
|
|
|
|
|
[browser extension](http://livereload.com/extensions/).
|
|
|
|
|
- You can debug application state using the
|
|
|
|
|
[React DevTools](https://reactjs.org/blog/2019/08/15/new-react-devtools.html) and
|
|
|
|
|
[Redux DevTools](https://github.com/reduxjs/redux-devtools) browser extensions.
|
