Skip to content

About

A web application that allows users to track and visualize IP address locations on an interactive map.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

IP Address Tracker

A modern web application that allows users to track and visualize IP address locations on an interactive map.

IP Address Tracker Screenshot

Features

  • 🔍 Search for any IP address or domain
  • 🗺️ View the location on an interactive map using Leaflet
  • 📊 Display key information about the IP address:
    • IP Address
    • Location (City, Region, Country)
    • Timezone
    • ISP (Internet Service Provider)
  • 📱 Fully responsive design for all device sizes
  • 📜 Search history tracking for quick access to previous searches
  • ⚡ Fast performance with React and Vite

Live Demo

View Live Demo

Technologies Used

  • Frontend Framework: React 18 with TypeScript
  • Styling: TailwindCSS for responsive design
  • Map: Leaflet with React-Leaflet integration
  • Icons: Lucide React
  • Build Tool: Vite
  • API: ipapi.co for IP geolocation data

Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn

Installation

  1. Clone the repository:

    git clone https://github.com/yosephdev/ip-address-tracker.git
    cd ip-address-tracker
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Start the development server:

    npm run dev
    # or
    yarn dev
  4. Open your browser and navigate to http://localhost:5173

Building for Production

To create a production build:

npm run build
# or
yarn build

The build files will be located in the dist directory.

To preview the production build locally:

npm run preview
# or
yarn preview

Project Structure

ip-address-tracker/
├── src/
│   ├── App.tsx          # Main application component
│   ├── index.css        # Global styles
│   ├── main.tsx         # Entry point
│   └── vite-env.d.ts    # Vite environment types
├── public/              # Static assets
├── index.html           # HTML template
├── package.json         # Project dependencies and scripts
├── tsconfig.json        # TypeScript configuration
├── vite.config.ts       # Vite configuration
├── tailwind.config.js   # Tailwind CSS configuration
└── README.md            # Project documentation

API Usage

This project uses the ipapi.co API to fetch IP address information. The free tier includes:

  • 1,000 requests per day
  • No API key required for basic usage
  • JSON response format

Example API response structure:

{
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "region": "California",
  "country_name": "United States",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "timezone": "America/Los_Angeles",
  "org": "Google LLC"
}

Future Enhancements

  • Add domain name lookup functionality
  • Implement dark mode toggle
  • Add more detailed IP information
  • Create shareable links for specific IP lookups
  • Add data visualization for IP statistics

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Yoseph Berhane

Acknowledgments

About

A web application that allows users to track and visualize IP address locations on an interactive map.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Used by

Contributors

Languages