Skip to content
This repository has been archived by the owner on Jan 16, 2023. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Fast and lightweight errors tracking service.

Platform documentation

Getting Started

Create an account

Register domain


Add server handler

Add client catcher



Our team

Platform documentation is a clever and easy-to-use errors tracker. It collects all your code exceptions and errors and helps you to improve applications.

Please, welcome to the simple user guide.

Getting Started

Integration scheme contains a three steps. Your need to register, add a domain and install one of the Catchers.

Create an account

Follow /join link to access registration form. Leave working email, and we will send you a password. You can change it at any time later.

After that you'll be entranced by internal section. We call it the Garage.

Register domains

Now, look at the Sidebar. There will appear all your registered domains. Touch «Add domain» button to create your first.

Fill domain's name and submit a form. Now you have an Integration Token.


All registration procedures passed, next step is an installation of the some error Catchers. They're simple scripts that collect exceptions and deliver them to the Garage.

Add the Server Handler

Currently, we provide Catchers for the next technologies:

This list will be expanded soon. If you can code, you can implement your own Catcher.

Add the Client Handler

To deliver JavaScript errors we provide the fast and non-blocking Socket-based Catcher.

Get JavaScript Catcher

How to use. Include <script> tag loaded from the CDN or local cloned exemplar.

<script src="hawk.js" async></script>

Next, initialize the module with your Integration Token.

    hawk.init({token: “INTEGRATION_TOKEN”});

Source map support

Hawk supports JS SourceMaps for showing more useful information from your minified bundle. There a few conditions:

  1. Bundle ends with line contains anchor to the source map, like //# It can be absolute or relative (relatively the bundle) path.
  2. Source map are publicly available by its URL.
  3. On every rebuilding you are updating the revision and pass it with `init` method. It can be heximal-hash or simply file's modification timestamp.
hawk.init({token: 'INTEGRATION_TOKEN', revision: 12345654345})


You can get notifications about catched errors to the Email, Telegram or Slack. For the last two types, we use Webhooks, so you free to use an any webhook bot, for example, our — @codex_bot.

Note about Webhook's query format. It is a POST-request with the message field contains notification's text.

To setup Notifications, open the Settings page, find a Project and click on the «Configure Webhooks» button. Then add Webhook endpoints for the Slack or Telegram and press «Save». Don't forget to activate checkboxes for the selected types.


Hawk now in a public beta stage. So we allow to collect up to {{ eventsLimit|counter }} events of different types by a Project. You can have a several Projects at one account.

Our team

CodeX is a small team of enthusiasts. We love web-development, build social and media services and trying to grow ourselves.

Please, leave a feedback on the our email We REALLY appreciate this. And thanks for reading.


Fast and lightweight errors tracking service








No releases published


No packages published