SDKs

Official NetLoc8 SDKs for JavaScript, React, Next.js, and Go. The JavaScript packages re-export their parent — install only the one that matches your framework.

Package Hierarchy

Each SDK builds on the previous one. Install only the most specific package for your framework:

@netloc8/core ← universal JS client

└─ @netloc8/react ← adds Provider, useGeo, GeoGate

└─ @netloc8/nextjs ← adds SSR proxy, getGeo, redirects

github.com/netloc8/netloc8-go ← standalone Go client

Feature Comparison

Featurecorereactnextjs
fetchGeo / fetchMyGeo✓✓✓
fetchTimezone / fetchMyTimezone✓✓✓
isEU() helper✓✓✓
Browser signals✓✓✓
NetLoc8Provider—✓✓
useGeo() hook—✓✓
GeoGate component—✓✓
getGeo() (server)——✓
createProxy()——✓
withGeoRedirect()——✓

Packages

JavaScript / Node.js

@netloc8/core

Universal IP geolocation client for Node.js, Bun, Deno, Cloudflare Workers, and the browser.

Bash
bun add @netloc8/core
fetchGeo / fetchMyGeofetchTimezone / fetchMyTimezoneisEU() helperBrowser signal collectionError-safe (never throws)

React

@netloc8/react

React context provider, useGeo() hook, and GeoGate component for conditional rendering by location.

Bash
bun add @netloc8/react
NetLoc8ProvideruseGeo() hookGeoGate componentCookie persistenceContent shift prevention

Next.js

@netloc8/nextjs

Full Next.js integration with SSR proxy, server components, React hooks, and geo-based redirects.

Bash
bun add @netloc8/nextjs
getGeo() server functioncreateProxy()withGeoRedirect()All React exportsSSR + client support

Go

netloc8-go

Zero-dependency, context-native Go client with nil-safe accessors, typed errors, and proxy support.

Bash
go get github.com/netloc8/netloc8-go
LookupIP / LookupMeNil-safe accessorsTyped *APIErrorIsEU / GetClientIPProxy-aware