IPWiz is an educational developer tool and live dashboard for the IPstack API, powered by APILayer. It allows you to inspect IP addresses, compare IP geolocation with browser geolocation, and see exactly how the IPstack API resolves an address in real-time.
- Live IP Lookup: See detailed IP information including location, connection details, timezone, and security data.
- Trace Panel: Inspect the exact request and JSON response from the IPstack API with a developer-friendly collapsible view.
- Geo Compare: Compare the geographical location from your IP address with your actual browser's geolocation using an interactive dark-themed Leaflet map.
- VPN / Proxy Detection: Built-in verdict display showing whether the IP is likely associated with a VPN, proxy, or data center.
- My Grabs: Persist and view earlier IP lookups using a local SQLite database (via Drizzle ORM).
- Dark & Light Themes: Automatic or manual toggling between dark and light modes.
- Framework: Next.js (App Router, React 19)
- Styling: Tailwind CSS v4
- Database: SQLite + Drizzle ORM + @libsql/client
- Maps: Leaflet with CartoDB Dark Matter tiles
- API: IPstack API by APILayer
First, make sure you have an IPstack API key. Create an .env.local file at the root of the project with your API key:
IPSTACK_ACCESS_KEY=your_api_key_hereThen, install the dependencies and run the development server:
npm install
npm run devOpen http://localhost:3000 with your browser to see the application running.
The project uses Drizzle ORM. Remember to generate and run migrations if you change the schema app/lib/db/schema.ts!
For setting up the local db initially:
npx drizzle-kit migrate
# or use drizzle studio to view data
npx drizzle-kit studio- IPstack API Documentation - Learn about the IPstack API
This project is intended as an educational devtool. Note that the data used within the app is © IPstack by APILayer.
