Skip to content

A modern, real-time IP address monitoring application that tracks your public IPv4 and IPv6 addresses with beautiful animations and change notifications.

Notifications You must be signed in to change notification settings

gitanshugit/ip-check

Repository files navigation

🌐 IP Tracker

A modern, real-time IP address monitoring application that tracks your public IPv4 and IPv6 addresses with beautiful animations and change notifications.

✨ Features

🎯 Core Functionality

  • Real-time IP Detection - Automatically fetches your current public IPv4 and IPv6 addresses
  • Geographic Location - Shows your country based on IP geolocation
  • Change Tracking - Monitors IP changes and maintains a comprehensive history
  • Smart Notifications - Animated alerts for IP changes and status updates
  • Persistent Storage - IP history saved locally using localStorage

🎨 Modern UI/UX

  • Responsive Design - Optimized for desktop, tablet, and mobile devices
  • Dark Theme - Sleek dark interface with gradient accents
  • Animated Text - Cyberpunk-style decrypted text animations
  • Material Design - Built with Material-UI components
  • Smooth Transitions - Hover effects and micro-interactions
  • Professional Layout - Clean, production-ready interface

🔧 Technical Features

  • TypeScript - Full type safety and better development experience
  • React Hooks - Modern React patterns with functional components
  • Real-time Updates - Manual refresh with loading states
  • Error Handling - Graceful error management and user feedback
  • Performance Optimized - Efficient rendering and state management

🚀 Quick Start

Prerequisites

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

Installation

  1. Clone the repository

    git clone https://github.com/gitanshugit/ip-check.git
    cd ip-check
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:5173 to view the application

Build for Production

npm run build
npm run preview

🛠️ Technology Stack

  • Frontend Framework: React 18 with TypeScript
  • UI Library: Material-UI (MUI) v5
  • Styling: Tailwind CSS + MUI Theme
  • Build Tool: Vite
  • Icons: Material-UI Icons
  • APIs:

🎮 Usage

  1. View Current IP: Your current IPv4 and IPv6 addresses are displayed prominently with country information
  2. Refresh Detection: Click the "Refresh IP" button to check for changes
  3. Monitor History: View up to 10 previous IP addresses in the history panel
  4. Notifications: Receive animated notifications when your IP changes or remains the same

🔒 Privacy & Security

  • No Data Collection: All data is stored locally in your browser
  • No Server Storage: IP history never leaves your device
  • Public APIs Only: Uses reputable public IP detection services
  • No Tracking: No analytics or user tracking implemented

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

🙏 Acknowledgments

  • APIs: Thanks to ipapi.co and ipify.org for providing free IP detection services
  • Design Inspiration: Modern cyberpunk and glassmorphism design trends
  • Icons: Material-UI Icons for consistent iconography

📞 Support

If you encounter any issues or have questions:

  1. Check the Issues page
  2. Create a new issue with detailed information
  3. Include browser version and error messages if applicable

Made with ❤️ by Gitanshu

⭐ Star this repo if you found it helpful!

About

A modern, real-time IP address monitoring application that tracks your public IPv4 and IPv6 addresses with beautiful animations and change notifications.

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •