📚 Domainstack - Domain Intelligence Tool

Domainstack is an all-in-one app for exploring domain names. Search any domain (e.g., github.com) and get instant insights including WHOIS/RDAP lookups, DNS records, SSL certificates, HTTP headers, hosting details, geolocation, and SEO signals.

---

🚀 Features

• Instant domain reports: Registration, DNS, certificates, HTTP headers, hosting & email, and geolocation.
• SEO insights: Extract titles, meta tags, social previews, canonical data, and robots.txt signals.
• Screenshots & favicons: Server-side screenshots and favicon extraction, stored in Vercel Blob.
• Fast, private, no sign-up: Live fetches with smart caching.
• Reliable data pipeline: Postgres persistence (Drizzle), background revalidation (Inngest), and Redis for short-lived caching/locks.

---

🛠️ Tech Stack

• 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
• rdapper for RDAP lookups with WHOIS fallback
• Puppeteer (with @sparticuz/chromium on server) for screenshots
• Mapbox for IP geolocation maps
• PostHog analytics with sourcemap uploads
• Vitest for testing and Biome for lint/format

---

🌱 Getting Started

1. Clone & install

git clone https://github.com/jakejarvis/domainstack.io.git
cd domainstack.io
pnpm install

2. Configure environment variables

Create .env.local (see .env.example for full details):

# --- 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.
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
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)

We provide a single docker-compose.yml and a helper script (start-dev-infra.sh) that boots all services and waits for them to be ready:

• Postgres on localhost:5432
• Neon wsproxy on localhost:5433 (WebSocket proxy used by the Neon serverless driver)
• Redis on localhost:6379
• Serverless Redis HTTP (SRH) on http://localhost:8079 (Upstash-compatible REST proxy)
• Inngest Dev Server on http://localhost:8288

Run:

pnpm docker:up

On Linux, if host.docker.internal isn't available, add extra_hosts to the Inngest service in docker-compose.yml:

extra_hosts: ["host.docker.internal:host-gateway"]

To stop everything cleanly:

pnpm docker:down

4. Run Drizzle database migrations & seeds

pnpm db:generate   # generate SQL from schema
pnpm db:migrate    # apply migrations to local Postgres
pnpm db:seed       # seed database (if needed)

5. Start the Next.js dev server

Run in a second terminal window:

pnpm dev

Open http://localhost:3000

---

🧰 Useful Commands

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          # 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: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)

---

📜 License

MIT

Toybrick by Ary Prasetyo from Noun Project (CC BY 3.0)