Docs / Examples

Integration Examples & Reference Implementations

This page mirrors the source files under docs/examples. Select a category to view the actual integration code for your stack.

Open developer portal Try the demo

Server Verification Kit (SVK)

Mandatory for production. Customer backends must validate short-lived, one-time verification tokens server-side before protected actions continue. These helpers implement canonical HMAC signing, replay protection, and fail-closed timeout behavior.

TypeScript / Backend

Node/TypeScript (SVK)

notabot.ts

Backend validation helper with HMAC signing and fail-closed timeout.

Open helper Raw source Download ZIP

PHP / Backend

PHP (SVK)

NotabotValidator.php

PSR-compatible backend validator with native cURL and secure comparison.

Open helper Raw source Download ZIP

Python / Backend

Python (SVK)

notabot_validator.py

Synchronous and asynchronous Python validation with HMAC support.

Open helper Raw source Download ZIP

Go / Backend

Go (SVK)

validator.go

Idiomatic Go validation helper with crypto/hmac and context support.

Open helper Raw source Download ZIP

Elixir / Backend

Elixir (SVK)

notabot_validator.ex

Native Elixir client for token validation using Req and :crypto.

Open helper Raw source Download ZIP

Bash / Backend

curl / Bash (SVK)

validate-token.sh

Shell-script validation examples with canonical signing contract.

Open helper Raw source Download ZIP

Frontend Widget Integration

Embed the Notabot widget to collect behavioral signals and receive verification tokens. These examples show how to handle the widget lifecycle and pass tokens to your backend.

TSX / Frontend

Quick Start

NotabotQuickStart.tsx

Simple end-to-end flow for a first integration.

Open file Raw source

TSX / Frontend

Next.js App Router

NextJsNotabotExample.tsx

Complete multi-file project structure with custom hook, provider, layout, page, and signed API validation.

Open file Raw source

TSX / Frontend

React Component

ReactNotabotExample.tsx

Component-level integration and token handling.

Open file Raw source

PHP / Frontend

PHP / WordPress

PhpWordpressExamples.php

Combined PHP, Laravel, and WordPress examples.

Open file Raw source Download Plugin

PHP / Frontend

Vanilla PHP

PhpNotabotExample.php

Pure PHP integration with session-based gating, HMAC signing, and no framework required.

Open file Raw source

Astro / Frontend

Astro + Cloudflare Pages

AstroNotabotExample.astro

Edge-ready Astro integration with Cloudflare Pages adapter and Web Crypto HMAC signing.

Open file Raw source

SDK Downloads

Download official SDK packages

Get the complete SDK packages for Node.js, Next.js, and the Doctor diagnostic tool.

Node.js SDK Next.js SDK Doctor Tool

Security Notice

Always verify humans at the backend, not just in the browser.

Frontend "verified" states are for UX only. The real proof resides in the server-validated token.

Try the public demo