📚 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 Cloudflare R2.
• 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 15 (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
• Cloudflare R2 (S3 API) 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
• 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 (used by pnpm dev):

# --- 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
# If your Inngest handler lives at a custom route, set:
INNGEST_SERVE_PATH=/api/inngest

# --- Object Storage (Cloudflare R2 in prod; MinIO locally) ---
# Local S3 emulator (MinIO) — the start script will auto-create the bucket when this endpoint is set:
R2_ENDPOINT=http://localhost:9000
R2_BUCKET=development
R2_ACCESS_KEY_ID=minioadmin
R2_SECRET_ACCESS_KEY=minioadmin
R2_PUBLIC_BASE_URL=http://localhost:9000/development

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
• MinIO (S3 API) on http://localhost:9000 (console at http://localhost:9001)

Run:

pnpm docker:up

On Linux, if host.docker.internal isn’t available, add extra_hosts to the Inngest and MinIO services 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:providers  # seed known providers in lib/providers/rules/

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 lint          # Biome lint/format checks
pnpm typecheck     # tsc --noEmit
pnpm test:run      # Vitest

# 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

---

📜 License

MIT

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