Docs

Everything you need to set up and live with Forewarn. Read top-to-bottom in five minutes.

Overview

Forewarn watches public web pages — competitor pricing, product changelogs, news, regulatory docs, anything — and tells you in one sentence when something meaningful ships. You add URLs, Forewarn renders and extracts them on a schedule, diffs them against the previous snapshot, and sends the summary to email or Slack.

The explicit goal is to be ignorable: quiet when nothing matters, loud exactly when something does.

Quick start

  1. Create an account. Free plan includes 5 URLs.
  2. Go to Dashboard and add a source + a URL to watch.
  3. Connect a destination in Settings — email by default, Slack via an incoming webhook.
  4. That's it. Forewarn will start checking on the next cron tick and notify you when a meaningful change lands.

Page types

Forewarn tunes its classifier per page type. When you add a URL, it's auto-classified into one of:

  • pricing — plan names, prices, feature bullets.
  • changelog — new entries or major version bumps.
  • blog — new posts only; unchanged listings ignored.
  • careers — new roles appearing or disappearing.
  • other — generic diff-based classification.

You can override the page type on any URL — useful for pages that look like one thing but behave like another (e.g. a pricing FAQ).

Check frequency

Each URL has a frequency: daily (default) or hourly (Pro and Team). Forewarn runs a dispatcher every 15 minutes; any URL whose next_check_at has passed gets queued.

Be aware that many small sites block bots that hammer them. Forewarn uses a real browser fingerprint and respects per-domain concurrency limits.

Classification

Every diff is labeled meaningful, minor, or ignore with a confidence score. Only meaningful changes trigger notifications.

The underlying rules — with examples — are:

  • pricing: any number, plan name, or feature bullet change → meaningful.
  • careers: new role → meaningful; role removed → minor.
  • blog/changelog: new post/entry → meaningful.
  • CSS, whitespace, analytics IDs, CSRF tokens, timestamps → ignore.

Notifications

Add as many destinations as your plan allows in Settings.

  • Email — a once-daily digest at 9am in your timezone, plus urgent alerts immediately.
  • Slack — paste an incoming webhook URL. One alert per meaningful change.

FAQ

What happens the first time a URL is checked?

We record a baseline snapshot and don't alert — there's nothing to diff against. Subsequent checks compare against the previous snapshot.

What if a page fails to load?

We retry with exponential backoff. Repeated failures surface in the URL's detail view.

Can I see the raw diff for a change?

Yes. The source detail page shows the unified diff alongside the summary.

Do you store the full page HTML?

Only the extracted text (required to diff) plus an optional screenshot. Full HTML is stored by reference in blob storage if retention is enabled.