📚 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, cached in Postgres with Vercel Blob storage.
• Fast, private, no sign-up: Live fetches with intelligent multi-layer caching.
• Reliable data pipeline: Postgres persistence with per-table TTLs (Drizzle), event-driven background revalidation (Inngest), and Redis for short-lived rate limiting.
• Dynamic configuration: Vercel Edge Config for runtime-adjustable rate limits and domain suggestions without redeployment.

🛠️ Tech Stack

• Next.js 16 (App Router) + React 19 + TypeScript
• Tailwind CSS v4
• tRPC API
• PlanetScale Postgres + Drizzle ORM with connection pooling
• Inngest for event-driven background revalidation with built-in concurrency control
• Upstash Redis for IP-based rate limiting
• Vercel Edge Config for runtime configuration (domain suggestions, service rate limits)
• Vercel Blob for favicon/screenshot storage with Postgres metadata caching
• rdapper for RDAP lookups with WHOIS fallback
• Puppeteer (with @sparticuz/chromium on Vercel) for server-side screenshots
• Mapbox for IP geolocation maps
• PostHog for analytics and error tracking with sourcemap uploads and reverse proxy
• OpenTelemetry via @vercel/otel for distributed tracing
• Vitest with React Testing Library 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 and populate required variables:

cp .env.example .env.local

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

4. Start development

The dev script uses concurrently to automatically start all local services and the Next.js dev server together:

pnpm dev

This single command boots:

• Postgres on localhost:5432
• Redis on localhost:6379
• Serverless Redis HTTP (SRH) on http://localhost:8079 (Upstash-compatible REST proxy)
• Inngest dev server on http://localhost:8288
• Next.js dev server on http://localhost:3000

Open http://localhost:3000. Press Ctrl+C to stop all services at once.

Note

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"]

🧰 Useful Commands

pnpm dev           # start all local services (Docker) + Next.js dev server
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)