AhmadJeddi/SafeIP

AhmadJeddi/SafeIP has 37 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-09 16:38 UTC. Last push 2026-08-31.

How these counts are measured

A lightweight network security tool that verifies IP location, validates network safety, and prevents access to protected links when unexpected location changes are detected.

37 stars 2 forks

Measured star growth

in 24h: 0
in 7 days: 0
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

SafeIP

Network Location Consistency Checker

A lightweight network security checker that verifies your current IP location before accessing sensitive online services.

SafeIP is a lightweight web application that compares your detected IP location with a user-selected country, helping you identify unexpected network location changes before accessing sensitive online services.

✨ Features

🌍 Network Security

Detect public IP address and IP-based network information
Compare detected and expected countries
Display network security status
Protect configured Quick Links based on validation results
Copy and refresh current network information

🔎 Country Selection

Searchable country selector
Keyboard navigation
Country flag, name, and ISO code display
Persist selected country using LocalStorage

🎨 User Experience

Dark / Light theme support
Skeleton / Shimmer loading states
Responsive design
Subtle Safe / Warning / Danger visual patterns
User-friendly validation feedback

⭐ PWA

Installable on supported browsers and devices
Standalone app display
Service Worker support
Static asset caching
Offline application shell
Offline state feedback
PWA icons and manifest metadata
Manual installation prompt when supported

🔐 Network Security Validation

SafeIP performs multiple checks before enabling protected Quick Links:

✅ Internet availability
✅ API response validity
✅ Country location match
✅ Protected link access

If required network information is unavailable, SafeIP reports the missing information instead of treating the network as unsafe.

🚀 How It Works

SafeIP follows this workflow:

User selects expected country
            |
            ↓
SafeIP retrieves network information
            |
            ↓
IP location is analyzed
            |
            ↓
Country comparison is performed
            |
            ↓
Security status is determined
            |
            ↓
Quick Links access is updated
            |
            ↓
Security status is displayed

🖥️ Preview

SafeIP Demo

🟢 Safe Network

The detected IP country matches the selected country.

Selected Country: Iran
Detected Country: Iran

Status:
Safe Network

🟡 Warning

Required network information is incomplete or unavailable.

Network information is unavailable

🔴 Unsafe Network

The detected country does not match the selected country.

Selected Country: Iran
Detected Country: Germany

Status:
Unsafe Network

🏗️ Project Structure

SafeIP/
├── index.html
├── manifest.webmanifest
├── service-worker.js
│
├── assets/
│   ├── favicon.png
│   ├── icon-192.png
│   ├── icon-512.png
│   ├── icon-192-maskable.png
│   ├── icon-512-maskable.png
│   └── preview.gif
│
├── css/
│   ├── reset.css
│   ├── variables.css
│   └── style.css
│
├── js/
│   ├── app.js
│   ├── api.js
│   ├── storage.js
│   ├── ui.js
│   ├── theme.js
│   ├── pwa.js
│   ├── validator.js
│   ├── countries.js
│   ├── quick-links-validator.js
│   └── config.js
│
├── README.md
├── project_structure.md
└── LICENSE

⚙️ Technologies Used

HTML5
CSS3
Vanilla JavaScript (ES Modules)
Fetch API
LocalStorage API
Public IP Geolocation APIs
CSS Variables
CSS Animations
Web App Manifest
Service Worker API
Cache API
PWA browser APIs

🔌 API Services

SafeIP uses public IP and geolocation services with fallback support.

Current providers:

GeoJS (Primary)
IPWho (Fallback)
HackMyIP (Last fallback)

If a service fails or does not provide sufficient network information, SafeIP attempts to use an available fallback service.

📦 Installation

Clone the repository:

git clone https://github.com/AhmadJeddi/SafeIP.git
cd SafeIP

Run the project using a local web server such as VS Code Live Server.

For PWA installation, serve SafeIP through HTTPS or a supported secure development environment such as localhost.

🔒 Privacy & Security

SafeIP does not intentionally persist your IP address in LocalStorage or other application storage.

SafeIP does not:

Collect personal information
Require account registration
Use cookies
Intentionally store your IP address persistently

Network information is retrieved from public IP geolocation services and used locally for security validation.

User preferences and Quick Links are stored locally in the browser using LocalStorage.

👨‍💻 Author

Ahmad JeddiZahed

⭐ Contributing

Contributions are welcome!

If you have ideas, find a bug, or want to improve the project, feel free to open an issue or submit a pull request.

If you find this project useful, consider giving it a ⭐ on GitHub.

📄 License

This project is licensed under the MIT License.

See the LICENSE file for details.