/projects/mr-geoip
mr-geoipbuild dossier
Node.jsBunDenoTypeScriptGeolocation
build.metadata
RoleCreator & Maintainer
DurationJuly 2026
StatusPublished on npm
TelemetryActive
overview
A production-grade, runtime-agnostic IP geolocation library for Node.js, Bun, and Deno. Features sub-millisecond in-memory lookups, configurable LRU caching, and an automatic HTTP fallback to public APIs.
implementation.notes
1Sub-millisecond in-memory lookups with a configurable LRU cache.
2Runtime-agnostic, supporting Node.js ≥ 18, Bun, and Deno.
3Serverless ready with a lightweight NPM shipment (only 163.4KB).
4Automatic HTTP fallback to public APIs if local databases are missing.
readonlyconnected
design.principles
Fast Lookups
Sub-millisecond in-memory lookups powered by an LRU cache.
Runtime Agnostic
Works out of the box on Node.js, Bun, and Deno environments.
Serverless Ready
Fully compatible with Vercel and AWS Lambda limits.
system.architecture
// In-Memory Engine
Uses local databases for sub-millisecond synchronous IP lookups.
// HTTP Fallback
Asynchronous fallback to public APIs like ipapi.co and FreeIPAPI.
// LRU Caching
Configurable LRU cache to optimize repeated asynchronous lookups.
Want to discuss a similar build?
Use this project as a reference point and send the workflow, timeline, and constraints you care about most.