Installation

Install errorcore once, initialize it early, and keep the setup narrow. The goal is to make the first captured failure trustworthy, not to overbuild the bootstrap path.

Install SDK

Install the package into the service that will emit incidents.

Terminal

npm install errorcore

Prepare secrets

Provide the encryption key through runtime secret management. Keep it out of source control and out of committed config files.

Terminal

export ERRORCORE_KEY=<your_encryption_key>

Initialize early

Place initialization in the first executable startup path, before routes, clients, or job handlers begin work.

server bootstrap

node -e "require(\"./server/bootstrap\")"

Check the boundary

Trigger one controlled error in development or staging and confirm that the first package includes the throw, request context, and any enabled IO.

service identity is correct
one incident is created for the failing path
locals and IO appear only if enabled
delivery succeeds or lands in dead-letter storage