# Tutorial

Canonical page: https://docs.ovok.com/signals/tutorial

<Effort complexity={2} clients="Any server: Node.js shown" time="30 minutes" />

You keep patients and readings in your own system. Signals judges each reading against a heart-rate band and tells your server when one breaches it, when someone acknowledges the alert, and when the patient recovers.

<Recording name="signals-alert-feed-demo" alt="A breaching reading raising an alert that arrives at a local receiver, then its acknowledgement" />

## What you'll build [#what-youll-build]

1. A local server that [receives and verifies](/signals/tutorial/local-server) Signals webhooks.
2. A [webhook subscriber](/signals/tutorial/register-webhook) that points Signals at it.
3. A [patient](/signals/tutorial/create-patient) and a [reading](/signals/tutorial/send-observation) that breaches the band.
4. The [finished app](/signals/tutorial/example-app).

If a delivery doesn't arrive, [debug it](/signals/tutorial/debugging).

## Create a sandbox project [Console] [#create-a-sandbox-project-console]

Sign in to the [Console](https://ovok.com/console?ref=docs) and create a project in the sandbox environment. Signals gives the project a [tenant of its own](/signals/standalone#your-signals-tenant) on its first request.

## Create the apps [Console] [#create-the-apps-console]

Create a **Manager** app, which runs the tenant and reads alerts, and a **Submitter** app, which posts readings. Copy each one's id and secret. [Get started](/signals/standalone/get-started) shows the steps, and [Applications](/applications) explains the types.

<Recording name="signals-create-apps" alt="Creating a Manager app and a Submitter app in the Console's Applications page" />

## Set the environment [Terminal] [#set-the-environment-terminal]

Save the credentials where every later page reads them:

```bash title=".env"
OVOK_MANAGER_ID=…
OVOK_MANAGER_SECRET=…
OVOK_SUBMITTER_ID=…
OVOK_SUBMITTER_SECRET=…
SIGNALS_SIGNING_SECRET=
```

Leave `SIGNALS_SIGNING_SECRET` empty: [Register the webhook](/signals/tutorial/register-webhook) gives it to you. Load the file into your shell with `set -a; source .env; set +a`.

## Next [#next]

[Run a local server](/signals/tutorial/local-server).
