Nightwatch aims to provide an easy-to-use wrapper around Selenium WebDriver. Even though at the time of writing it's quite outdated, compared to other current alternatives, but it's still OK for simple cases. However, trying to build a large, maintainable set of test suites for modestly sized web app uncovers quite a few shortcomings. This text aims to list them and for each one describe both the issue and some way to work around it.
Note that this text is meant to supplement Nightwatch Developer Guide, not replace it.