⚡ Universal Dev Registry Webapp

The Universal Dev Registry Webapp is a high-performance, cross-ecosystem package compatibility engine.
Built with a terminal-inspired cyber aesthetic, it enables developers to simulate package queues and detect version conflicts across global registries (NPM, PyPI, Crates.io, and more) — directly in the browser.

---

🛠️ Tech Stack

Core

• Framework: Next.js 16 (App Router)
• Core Logic: React 19 + Axios
• Auth & Security: Next-Auth + FingerprintJS

UI & Animation

• Styling: Tailwind CSS 4
• Icons: Lucide React & Radix Icons

Component Libraries

• Shadcn UI: Progress, Dropdown, Card, Input, Separator, Tooltips
• Magic UI: Bento Grid, Marquee, Neon Gradient Card
• React Bits: Fuzzy Text

---

🚀 Key Features

• 🔎 Multi-Registry Hybrid Search Unified, low-latency search across NPM, PyPI, Crates.io, Packagist, Homebrew, and curated OS-level tools.
  Access global registries through a single, high-fidelity terminal interface.

• 🧠 Smart Conflict Detection An intelligent backend proxy validates your staged package queue against a global database of known “Dependency Hell” version mismatches.
  Detects incompatible protocols before you even run the install command.

• 🔐 The Identity Vault (v2.0) State-of-the-art authentication gateway powered by Next-Auth.
  Seamless GitHub / Google OAuth integration ensures that only verified nodes can access the Staging Queue and generate CLI deployment scripts.

• 🛡️ The Identity Shield Advanced middleware security layer utilizing secret-key handshakes and IP-based threat detection.
  This shield protects the registry matrix from automated scrapers and unauthorized registry exploration.

• 📱 Responsive Cyber-Terminal UI A high-fidelity, cross-device interface designed for both desktop workstations and mobile devices, featuring:

  • Adaptive Matrix
    A fluid compatibility grid that reflows for mobile viewports.

  • Fuzzy-Logic Search
    Real-time filtering with weighted results.

  • Neon-Gradient UI
    Built with Magic UI components for a premium cyber aesthetic.

  • Real-time Status Logging
    Visual feedback for system initialization and registry access.

---

📥 Deployment Staging

Generate production-ready CLI commands for your favourite package managers
(NPM, Yarn, PNPM, Bun, Cargo, Pip, UV, and more) — only after passing protocol authorization via the Identity Vault.

---

📥 Installation & Setup

1️⃣ Clone & Initialize

git clone https://github.com/Ambastha-Org/Universal-Dev-Registry-WebApp.git
cd web

2️⃣ Install Core Dependencies

npm install axios lucide-react @radix-ui/react-icons markdown-to-jsx \
@fingerprintjs/fingerprintjs clsx tailwind-merge

3️⃣ Install UI Primitive Components

To install UI primitives from Shadcn, Magic UI, and React Bits:

npm install tailwindcss-animate class-variance-authority

npx shadcn@latest add @react-bits/FuzzyText-JS-CSS input progress dropdown-menu card separator tooltip

npx shadcn@latest add @magicui/bento-grid @magicui/marquee @magicui/neon-gradient-card

npx shadcn@latest add @react-bits/FuzzyText-JS-CSS

4️⃣ Configure Environment

Create a .env.local file in the web root:

NEXT_PUBLIC_DB_NAME="/unified_compatibility_matrix.json"
NEXT_PUBLIC_BACKEND_URI="https://api.ambastha.org/api/v1/matrix"
INTERNAL_API_SECRET="your_shared_secret_key"
AUTH_SECRET="your_next_auth_secret" 
GH_CLIENT_ID="your_github_id"
GH_CLIENT_SECRET="your_github_secret"
GOOGLE_CLIENT_ID="your_google_id"
GOOGLE_CLIENT_SECRET="your_google_secret"
NEXTAUTH_URL="http://localhost:3000"

🐳 Docker Deployment (Render / Self-Hosted)

Docker is used for consistent and reproducible deployments across environments.

• Start the Docker stack in detached mode.

  npm run docker:up

• View real-time application logs.

  npm run docker:logs
  

• Stop the currently running container.

  npm run docker:stop
  

⚖️ License

This project is protected under the Business Source License 1.1 (BSL-1.1).

Users must explicitly agree to the LicenseOverlay terms regarding registry access and conflict reporting before accessing the full explorer.