Skip to content

Repository files navigation

๐Ÿ›ก๏ธ Alpha Plus VPN

Next-Generation, NordVPN-Inspired Mobile VPN for Android & Web โ€” Powered by NordLynx, WireGuard, OpenVPN, and Pritunl Enterprise Zero-Trust Clusters.

Android React 19 TypeScript Capacitor Tailwind CSS v4 License


๐Ÿ“Œ Project Overview

Alpha Plus VPN is a mobile-first, high-performance Virtual Private Network application designed to match the official NordVPN mobile aesthetic and security standards. It combines an ultra-modern dark Nordic interface with deep cryptographic integrations, including NordLynx (WireGuard), OpenVPN UDP/TCP, and open-source Pritunl Enterprise server profile imports.

Whether running as an installable standalone Android PWA or compiled into a native Android APK via Capacitor, Alpha Plus VPN delivers a fluid, responsive, and secure experience.


๐ŸŒŸ Key Features

1. ๐Ÿ›ก๏ธ 1-Tap Quick Connect Dashboard

  • Iconic Glowing Radar Power Button: Visual state machine with animated radar waves when connecting, emerald/cyan glow when protected, and live connection timer.
  • Smart IP Concealment: Automatically detects real public IP & ISP when disconnected and swaps to an encrypted virtual IP upon tunnel establishment.
  • Collapsible Network Telemetry: Smooth HTML5 Canvas waveform plotting continuous download/upload throughput and live millisecond ping.

2. ๐Ÿ—บ๏ธ Interactive "Where-to-Where" World Map

  • Great-Circle Bezier Arcs: Renders curved ballistic laser trajectories connecting your physical origin to your target VPN exit node.
  • Flying Encrypted Data Photons: Animated particle packets traverse along the curve in real time to visualize live packet tunneling.
  • Multi-Hop Double VPN: Dual-arc routing visualization for multi-hop privacy servers (e.g., US โ†’ Switzerland).
  • Live Route HUD: Displays origin city, exit city, live distance in kilometers, encryption cipher, and an instant "Center Route" camera auto-fit button.

3. ๐ŸŒ Global Server Directory & Pritunl Importer

  • 60+ Countries & 150+ Worldwide Nodes: Searchable by country, city, server ID, or IP address.
  • Specialty Categories:
    • ๐ŸŒ All Countries (Americas, Europe, Asia-Pacific, Africa, Middle East)
    • โšก Fastest Locations (Optimized for ultra-low latency)
    • ๐Ÿ›ก๏ธ Double VPN (Two-layer multi-hop server routing)
    • ๐Ÿš€ P2P Sharing (High-throughput torrenting & streaming)
    • ๐Ÿง… Onion Over VPN (Tor network routing integration)
    • ๐Ÿ•ต๏ธ Stealth Obfuscation (Bypasses Deep Packet Inspection & firewalls)
    • ๐Ÿข Pritunl Enterprise Clusters (Import custom pritunl:// URIs or raw .ovpn configuration profiles)

4. ๐Ÿ”’ CyberSec Threat Protection & Breach Scanner

  • Ad & Tracker Blocker: Real-time counters for blocked ads, web trackers, and malicious phishing domains.
  • Dark Web Breach Scanner: Search email addresses against simulated breach intelligence dumps (Dropbox, Adobe, LinkedIn dumps) with compromised credential reports and remediation advice.

5. โšก Built-In Speedometer & Diagnostics

  • Speed Test Engine: Animated dial gauge measuring Ping (ms), Jitter (ms), Download (Mbps), and Upload (Mbps).
  • Speed Test History: Records previous test results with date and server tags.
  • Live Handshake Terminal: Real-time console showing WireGuard/OpenVPN/Pritunl cryptographic negotiation events with copy/export tools.

6. โš™๏ธ Privacy Controls & Native Android Frame

  • Multi-Protocol Switcher: Choose between NordLynx (WireGuard), OpenVPN (UDP), OpenVPN (TCP), and Stealth Obfuscation.
  • System Kill Switch: Always-on internet fail-safe blocking data leaks if the VPN drops.
  • App Split Tunneling: Whitelist/blacklist Android applications (Banking, Netflix, WhatsApp) to bypass VPN routing.
  • Custom Encrypted DNS: Switch between NordLynx DNS, Cloudflare (1.1.1.1), AdGuard Ad-Blocking DNS, Google DNS, or custom IP resolvers.
  • Android Notification Shade: Swipe or tap the top status bar / camera notch to open simulated Android 14 Quick Settings tiles.

๐Ÿ—๏ธ Architecture

graph TD
    App[Alpha Plus VPN Core] --> B[1. Quick Connect Dashboard]
    App --> C[2. Interactive World Map]
    App --> D[3. Server Directory & Pritunl Importer]
    App --> E[4. Threat Protection & Dark Web Scanner]
    App --> F[5. Speed Test & Diagnostic Terminal]
    App --> G[6. Settings & Protocol Engine]

    B --> B1[Live Real/Virtual IP Detection]
    B --> B2[NordLynx Power Button]
    B --> B3[Real-time Bandwidth Waveform]

    C --> C1[Ballistic Great-Circle Laser Arc]
    C --> C2[Flying Photon Data Packets]
    C --> C3[Where-To-Where Route HUD]

    D --> D1[60+ Country Nodes with Live Ping]
    D --> D2[Pritunl URI & .ovpn Profile Parser]
    D --> D3[Double VPN, P2P, Onion, Stealth]

    G --> G1[Kill Switch & Split Tunneling]
    G --> G2[Custom DNS & Cipher Selection]
    G --> G3[OpenVPN/WireGuard Handshake Logs]
Loading

๐Ÿš€ Getting Started

Prerequisites

  • Node.js: v18.0 or higher
  • NPM: v9.0 or higher

1. Installation

Clone the repository and install dependencies:

git clone https://github.com/your-username/alpha-plus-vpn.git
cd alpha-plus-vpn
npm install

2. Development Server

Start the local development server:

npm run dev

Open http://localhost:5173 in your browser.


๐Ÿ“ฑ Testing on Android Mobile

Option A: Instant Wi-Fi Preview / PWA (Recommended)

  1. Ensure your Android phone and PC are connected to the same Wi-Fi network.
  2. Open Chrome on your phone and navigate to:
    http://<YOUR_PC_LOCAL_IP>:5173
    
  3. Tap Chrome's menu (โ‹ฎ 3 dots) โ†’ Tap "Add to Home screen" or "Install app".
  4. Launch Alpha Plus VPN directly from your home screen in full-screen standalone mobile mode.

Option B: Build Native Android APK (Android Studio)

# 1. Build web distribution bundle
npm run build

# 2. Add Android native platform (one-time setup)
npx cap add android

# 3. Sync web assets with Android project
npx cap sync android

# 4. Open in Android Studio to build APK or run via USB debugging
npx cap open android

๐Ÿ› ๏ธ Technology Stack

Component Technology
Framework React 19 + TypeScript
Build Tool Vite 8 with @tailwindcss/vite
Styling Tailwind CSS v4 (Nordic Dark Cyber Theme)
Mobile Runtime Capacitor 8 (Android Bridge)
Icons Lucide React
Visuals & Charts HTML5 Canvas Waveforms, SVG Great-Circle Projections, Canvas Confetti
Server Specs Pritunl Core URI & OpenVPN .ovpn Parser

๐Ÿ“„ License

This project is open-source and available under the MIT License.

About

๐Ÿ›ก๏ธ Alpha Plus VPN โ€” Next-generation, NordVPN-inspired mobile VPN app for Android & Web. Features NordLynx & Pritunl Enterprise Zero-Trust clusters, interactive Great-Circle trajectory mapping, real-time bandwidth telemetry, speed testing, and cybersecurity suite.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages