Amok is a free open source, editor agnostic, cross-platform command line
tool for a hassle-free live development, testing and debugging workflow for web browsers.
It aims to make the development workflow feel like a native script runtime with a zero configuration development server that supports pre-processing, a read-eval-print-loop and console mirroring to standard output.
It has additional features to enable live editing, primarily hot patching which allows you to edit the source code of scripts that are currently active on the page, which will then be re-sourced while the application is running. There is also generic file watch events for handling hot swapping of resources in a domain specific manner, like reloading css, images, et cetera.
INSTALLATION
Install through npm
$ npm install --global amok
Note that amok requires node.js v0.12 or greater
USAGE
Open about:blank in Google Chrome and enter a read-eval-print-loop
$ amok --interactive --browser chrome about:blank
Start a server that generates an index.html page with the given index.js file as a script element.
$ amok --browser chrome index.js
Open chrome with hot patching enabled for the specified entry point
$ amok --browser chrome --hot file://$PWD/index.html
DOCUMENTATION
See the getting started guide, examples and manuals.
SUPPORT
- If you need help, ask in the chat.
- If you found a bug, submit an issue.
- If you have an idea, submit an issue.
- If you’d like to ask a general question, submit an issue.
- If you want to contribute, submit a pull request.
RELEASES
LICENSE
The project is licensed under the MIT License.
SPONSORS
The project is free and open source, and has been backed by a number of
individuals and organizations, a special thanks goes out to
Webflow, Apperson Labs and
Daft Developers.
A special thanks also goes out to Daniel Martinez, Dan Abramov and Tom Alon for going above and beyond in supporting development.
