Remove Vercel toolbar

Author: jakejarvis

AGENTS.md

@@ -5,23 +5,32 @@
 - `components/` reusable UI primitives (kebab-case files, PascalCase exports).
 - `hooks/` shared stateful helpers (camelCase named exports).
 - `lib/` domain utilities and caching (`lib/cache`); import via `@/...` aliases.
+- `lib/inngest/` Inngest client and functions for background jobs and scheduled section revalidation.
 - `server/` backend integrations and tRPC routers; isolate DNS, RDAP/WHOIS, TLS, and header probing services.
-- `server/db/` Drizzle ORM schema, migrations, and repository layer for Postgres persistence.
-- `server/inngest/` Inngest functions for background jobs and scheduled section revalidation.
+- `server/routers/` tRPC router definitions (`_app.ts` and domain-specific routers).
+- `server/services/` service layer for domain data fetching (DNS, certificates, headers, hosting, registration, SEO, screenshot, favicon, etc.).
+- `lib/db/` Drizzle ORM schema, migrations, and repository layer for Postgres persistence.
 - `public/` static assets; Tailwind v4 tokens live in `app/globals.css`. Update `instrumentation-client.ts` when adding analytics.
+- `trpc/` tRPC client setup, query client, and error handling.
 
 ## Build, Test, and Development Commands
 - `pnpm dev` — start dev server at http://localhost:3000.
 - `pnpm build` — compile production bundle.
 - `pnpm start` — serve compiled output for smoke tests.
+- `pnpm docker:up` — start all Dockerized local services (Postgres, Redis, SRH, Inngest) and wait until ready.
+- `pnpm docker:down` — stop all Dockerized local services.
 - `pnpm lint` — run Biome lint + type-aware checks (`--write` to fix).
 - `pnpm format` — apply Biome formatting.
 - `pnpm typecheck` — run `tsc --noEmit` for stricter diagnostics.
-- `pnpm db:generate` — generate Drizzle migrations.
+- `pnpm test` — run Vitest in watch mode.
+- `pnpm test:run` — run Vitest once.
+- `pnpm test:ui` — open Vitest UI.
+- `pnpm test:coverage` — run tests with coverage report.
+- `pnpm db:generate` — generate Drizzle migrations from schema.
 - `pnpm db:push` — push the current schema to the database.
 - `pnpm db:migrate` — apply migrations to the database.
 - `pnpm db:studio` — open Drizzle Studio.
-- `pnpm db:seed:providers` — seed known provider rules.
+- `pnpm db:seed` — run seed script (scripts/db/seed.ts).
 - Requires Node.js >= 22 (see `package.json` engines).
 
 ## Coding Style & Naming Conventions
@@ -37,24 +46,25 @@
 ## Testing Guidelines
 - Use **Vitest** with React Testing Library; config in `vitest.config.ts`.
 - Global setup in `vitest.setup.ts`:
-  - Mocks analytics clients/servers and `server-only`.
+  - Mocks analytics clients/servers (`@/lib/analytics/server` and `@/lib/analytics/client`).
+  - Mocks `server-only` module.
   - `unstable_cache` mocked as a no-op; caching behavior is not under test.
-- Database in tests: Drizzle client is not globally mocked. Replace `@/server/db/client` with a PGlite-backed instance when needed.
+- Database in tests: Drizzle client is not globally mocked. Replace `@/server/db/client` with a PGlite-backed instance when needed (`@/lib/db/pglite`).
 - Redis in tests: do NOT use globals. Mock per-suite with the in-memory adapter:
   - In `beforeAll`: `const { makeInMemoryRedis } = await import("@/lib/redis-mock"); const impl = makeInMemoryRedis(); vi.doMock("@/lib/redis", () => impl);`
   - In `beforeEach`/`afterEach`: `const { resetInMemoryRedis } = await import("@/lib/redis-mock"); resetInMemoryRedis();`
   - Seed/assert via the mocked client: `const { redis } = await import("@/lib/redis"); await redis.set(key, value);`
 - UI tests:
   - Do not add direct tests for `components/ui/*` (shadcn).
   - Mock Radix primitives (Accordion, Tooltip) when testing domain sections.
-  - Mock TRPC/React Query for components like `Favicon` and `Screenshot`.
+  - Mock tRPC/React Query for components like `Favicon` and `Screenshot`.
 - Server tests:
   - Prefer `vi.hoisted` for ESM module mocks (e.g., `node:tls`).
   - Use unique cache keys/domains; call `resetInMemoryRedis()` in `afterEach`.
   - Screenshot service (`server/services/screenshot.ts`) uses hoisted mocks for `puppeteer`/`puppeteer-core` and `@sparticuz/chromium`.
   - Vercel Blob storage: mock `@vercel/blob` (`put` and `del` functions). Set `BLOB_READ_WRITE_TOKEN` via `vi.stubEnv` in suites that touch uploads/deletes.
 - Browser APIs: Mock `URL.createObjectURL`/`revokeObjectURL` with `vi.fn()` in tests that need them.
-- Commands: `pnpm test`, `pnpm test:run`, `pnpm test:coverage`.
+- Commands: `pnpm test`, `pnpm test:run`, `pnpm test:ui`, `pnpm test:coverage`.
 
 ## Commit & Pull Request Guidelines
 - Commits: single-focus, imperative, sentence case (e.g., "Add RDAP caching layer").
@@ -66,15 +76,14 @@
 - Vercel Blob backs favicon/screenshot storage with automatic public URLs.
 - Screenshots (Puppeteer): prefer `puppeteer-core` + `@sparticuz/chromium` on Vercel.
 - Persist domain data in Postgres via Drizzle; use Redis for short-lived caching/locks. Apply retry backoff to respect provider limits.
-- Background revalidation runs via Inngest functions (scheduled and event-driven).
-- Review `server/trpc.ts` when extending procedures to ensure auth/context remain intact.
+- Background revalidation runs via Inngest functions (scheduled and event-driven) in `lib/inngest/functions/`.
+- Cron jobs trigger Inngest events via `app/api/cron/` endpoints secured with `CRON_SECRET`.
+- Review `trpc/init.ts` when extending procedures to ensure auth/context remain intact.
 
-## Feature Flags
-- Uses **Vercel Flags SDK** with **Statsig** adapter via Edge Config for server-evaluated feature flags.
-- Flag definitions: `flags.ts` at project root exports flag declarations.
-- Flags API endpoint: `app/.well-known/vercel/flags/route.ts` for Vercel Toolbar integration.
-- Server-side evaluation: Use flags in server components or API routes via `await flagName()`.
-- Required env: `FLAGS_SECRET` (for encryption/overrides), `EDGE_CONFIG` (Vercel Edge Config URL).
-- Optional env: `STATSIG_CONSOLE_API_KEY` and `STATSIG_PROJECT_ID` for Flags Explorer metadata in Vercel Toolbar.
-- Statsig config structure: Dynamic configs return JSON objects (e.g., `{ domains: [...] }`); use adapter's mapping function to extract values.
-- Defensive validation: Always validate flag return values with `Array.isArray()` or similar checks before use to handle null/undefined/invalid types gracefully.
+## Analytics & Observability
+- Uses **PostHog** for analytics and error tracking with reverse proxy via `/_proxy/ingest/*`.
+- PostHog sourcemap uploads configured in `next.config.ts` with `@posthog/nextjs-config`.
+- OpenTelemetry integration via `@vercel/otel` in `instrumentation.ts`.
+- Client-side analytics captured via `posthog-js` and initialized in `instrumentation-client.ts`.
+- Server-side analytics captured via `posthog-node` in `lib/analytics/server.ts`.
+- Analytics mocked in tests via `vitest.setup.ts`.

README.md

@@ -18,18 +18,17 @@
 
 ## 🛠️ Tech Stack
 
-- **Next.js 15** (App Router) + **React 19** + **TypeScript**
+- **Next.js 16** (App Router) + **React 19** + **TypeScript**
 - **Tailwind CSS v4**
 - **tRPC** API
 - **Postgres** + **Drizzle ORM**
 - **Inngest** for background jobs and scheduled revalidation
 - **Upstash Redis** for caching, rate limits, and locks
 - **Vercel Blob** for favicon/screenshot storage
-- **Vercel Flags SDK** + **Statsig** for feature flags (via Edge Config)
 - [**rdapper**](https://github.com/jakejarvis/rdapper) for RDAP lookups with WHOIS fallback
 - **Puppeteer** (with `@sparticuz/chromium` on server) for screenshots
 - **Mapbox** for IP geolocation maps
-- **PostHog** analytics
+- **PostHog** analytics with sourcemap uploads
 - **Vitest** for testing and **Biome** for lint/format
 
 ---
@@ -46,27 +45,46 @@ pnpm install
 
 ### 2. Configure environment variables
 
-Create `.env.local` (used by `pnpm dev`):
+Create `.env.local` (see `.env.example` for full details):
 
 ```env
+# --- PostHog Analytics ---
+NEXT_PUBLIC_POSTHOG_HOST=
+NEXT_PUBLIC_POSTHOG_KEY=
+POSTHOG_API_KEY=
+POSTHOG_ENV_ID=
+
 # --- Database (local) ---
 # TCP URL used by Drizzle CLI & direct TCP usage
 DATABASE_URL=postgres://postgres:postgres@localhost:5432/main
 
 # --- Redis (local via SRH) ---
-# SRH mimics Upstash REST locally; point your app’s Upstash client here.
+# SRH mimics Upstash REST locally; point your app's Upstash client here.
 KV_REST_API_URL=http://localhost:8079
 KV_REST_API_TOKEN=dev-token
 
 # --- Inngest Dev Server ---
 INNGEST_DEV=1
 INNGEST_BASE_URL=http://localhost:8288
-# If your Inngest handler lives at a custom route, set:
 INNGEST_SERVE_PATH=/api/inngest
+# Production: set INNGEST_EVENT_KEY and INNGEST_SIGNING_KEY
 
 # --- Vercel Blob Storage ---
 # Obtain from Vercel dashboard or use test token locally
 BLOB_READ_WRITE_TOKEN=your-token-here
+# Production: set BLOB_SIGNING_SECRET for blob key hashing
+
+# --- Vercel Cron ---
+# Required for authenticating scheduled tasks
+CRON_SECRET=
+
+# --- Mapbox ---
+# Public token for react-map-gl
+NEXT_PUBLIC_MAPBOX_TOKEN=
+
+# --- Optional ---
+# Override user agent sent with upstream requests
+EXTERNAL_USER_AGENT=
 ```
 
 ### 3. Start local dev services (Docker)
@@ -102,7 +120,7 @@ pnpm docker:down
 ```bash
 pnpm db:generate   # generate SQL from schema
 pnpm db:migrate    # apply migrations to local Postgres
-pnpm db:seed:providers  # seed known providers in lib/providers/rules/
+pnpm db:seed       # seed database (if needed)
 ```
 
 ### 5. Start the Next.js dev server
@@ -123,15 +141,22 @@ Open [http://localhost:3000](http://localhost:3000)
 pnpm dev           # start Next.js dev server
 pnpm docker:up     # start Dockerized local services and wait until ready
 pnpm docker:down   # stop all Dockerized local services (docker compose down)
+pnpm build         # compile production bundle
+pnpm start         # serve compiled output for smoke tests
 pnpm lint          # Biome lint/format checks
+pnpm format        # apply Biome formatting
 pnpm typecheck     # tsc --noEmit
-pnpm test:run      # Vitest
+pnpm test          # Vitest (watch mode)
+pnpm test:run      # Vitest (single run)
+pnpm test:ui       # Vitest UI
+pnpm test:coverage # Vitest with coverage report
 
 # Drizzle
-pnpm db:generate    # generate SQL migrations from schema
-pnpm db:migrate     # apply db migrations
-pnpm db:studio      # open Drizzle Studio against your current env URL
-pnpm db:seed:providers
+pnpm db:generate   # generate SQL migrations from schema
+pnpm db:push       # push the current schema to the database
+pnpm db:migrate    # apply migrations to the database
+pnpm db:studio     # open Drizzle Studio
+pnpm db:seed       # run seed script (scripts/db/seed.ts)
 ```
 
 ---

app/layout.tsx

@@ -1,5 +1,4 @@
 import { Analytics } from "@vercel/analytics/next";
-import { VercelToolbar } from "@vercel/toolbar/next";
 import { GeistMono } from "geist/font/mono";
 import { GeistSans } from "geist/font/sans";
 import type { Metadata } from "next";
@@ -47,7 +46,6 @@ export default function RootLayout({
           <Toaster />
         </Providers>
         <Analytics />
-        {process.env.NODE_ENV === "development" && <VercelToolbar />}
       </body>
     </html>
   );

next.config.ts

@@ -1,5 +1,4 @@
 import { withPostHogConfig } from "@posthog/nextjs-config";
-import withVercelToolbar from "@vercel/toolbar/plugins/next";
 import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
@@ -38,13 +37,11 @@ const nextConfig: NextConfig = {
   skipTrailingSlashRedirect: true,
 };
 
-export default withVercelToolbar()(
-  withPostHogConfig(nextConfig, {
-    personalApiKey: process.env.POSTHOG_API_KEY as string,
-    envId: process.env.POSTHOG_ENV_ID as string,
-    host: process.env.NEXT_PUBLIC_POSTHOG_HOST || "https://us.i.posthog.com",
-    sourcemaps: {
-      enabled: true,
-    },
-  }),
-);
+export default withPostHogConfig(nextConfig, {
+  personalApiKey: process.env.POSTHOG_API_KEY as string,
+  envId: process.env.POSTHOG_ENV_ID as string,
+  host: process.env.NEXT_PUBLIC_POSTHOG_HOST || "https://us.i.posthog.com",
+  sourcemaps: {
+    enabled: true,
+  },
+});

package.json

@@ -48,7 +48,6 @@
     "@vercel/blob": "^2.0.0",
     "@vercel/functions": "^3.1.4",
     "@vercel/otel": "^2.1.0",
-    "@vercel/toolbar": "^0.1.41",
     "cheerio": "^1.1.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",