mirror of
https://github.com/jakejarvis/domainstack.io.git
synced 2025-12-02 19:33:48 -05:00
e527ef43aca15dba60b032ff815d00c6b36e55ad
refactor: update analytics integration to use unified tracking methods across client and server (#181)
📚 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.txtsignals. - 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) and event-driven background revalidation (Inngest).
- Dynamic configuration: Vercel Edge Config for runtime-adjustable 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
- Vercel Edge Config for runtime configuration (domain suggestions)
- Vercel Blob for favicon/screenshot storage with Postgres metadata caching
- rdapper for RDAP lookups with WHOIS fallback
- Puppeteer (with
@sparticuz/chromiumon 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/otelfor 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 - 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.internalisn't available, addextra_hoststo the Inngest service indocker-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
Toybrick by Ary Prasetyo from Noun Project (CC BY 3.0)
Languages
TypeScript
98.9%
CSS
0.8%
Shell
0.3%