How do I add custom error pages?

My web app is hosted with the Aerobatic add-on for Bitbucket, and now I'd like to add a custom error page such as a 404 Page Not Found.

Step-by-step guide

  1. Navigate to your web site's repository
  2. Create a new HTML file named 404.html. You can have this file in your root or in a folder such as /errors, for example. 
  3. Add your cool Page Not Found content in your newly created 404.html file.
  4. Repeat Steps 2 and 3 for each custom error you want to handle. Aerobatic supports the following error codes: 400, 404, 401, 403, 500
  5. Either create a package.json file or, in your existing package.json, add the following code block. Make sure your package.json is in the root level of your repository.
  6. Push your updated code to your repo.

  "_virtualApp": {
    "router": [
        "module": "custom-errors",
        "options": {
          "errors": {
            "500": "errors/500.html",
            "404": "errors/404.html",
            "401": "errors/401.html"
        "module": "webpage"

Sample App

Further Documentation

Full documentation on custom errors can be found on which is the open-source project that Aerobatic is built on.