🛡️ AIX-Scanner: Premium Code Vulnerability Engine

AIX-Scanner is an advanced, high-performance static application security testing (SAST) tool. It uses specialized, rule-based heuristics to scan source code for critical security flaws (like SQL Injections, Hardcoded Secrets, Command Injections, and XSS) and automatically generates syntactically accurate multi-line fixes.

The application is wrapped in a breathtaking, premium "CleanMyMac"-inspired glassmorphic UI that actively responds to the real-time risk scores of your codebase.

---

🌟 Key Features

• Advanced Remediation Engine: AIX-Scanner doesn't just guess where to place code. It calculates structural array index positioning and line indentations, allowing it to perform exact multi-line surgical code replacements without leaving duplicate variables or ghost statements behind.
• Intelligent Auto-Fix: Run "Auto-Fix All" to sequentially repair dozens of attack vectors simultaneously across your file, and safely inject missing backend imports automatically.
• Premium Dynamic UI: The interface employs heavy framer-motion animations, reactive background color pooling (Safe / Critical domains), and sleek glass layout panels with completely fluid mobile responsive drawer states.
• Encrypted History: Every scan and its exact resulting code output is preserved in your history catalog for auditing.
• Extensible Architecture: Switch targets instantly across Python, JS, Java, and C++ ecosystems.

---

🛠️ Technology Stack

• Frontend Layout: React 18, Vite, TailwindCSS v4, Framer Motion, Lucide React.
• Backend Architecture: Python 3.11, FastAPI, Uvicorn, Pydantic.
• Deployment: Pre-configured infrastructure blueprints for direct zero-config Vercel (Client) and Render (API) deployment.

---

🚀 Local Development Setup

To run AIX-Scanner locally on your machine, you'll need Node.js and Python 3.11 installed.

1. Start the API Backend

cd backend

# Create a virtual environment and activate it
python -m venv venv
source venv/bin/activate  # (On Windows use: venv\Scripts\activate)

# Install ultra-lightweight REST engine dependencies
pip install -r requirements.txt

# Start the uvicorn server on localhost:8000
uvicorn app.main:app --reload --port 8000

2. Start the Client UI

Open a new terminal window.

cd frontend

# Install UI modules
npm install

# Start the Vite development server on localhost:5173
npm run dev

---

🌍 Production Deployment

This repository is strictly locked and optimized for zero-cost cloud deployment via specific configuration files render.yaml and .python-version.

Deploying the Backend (Render)

1. Go to Render.com, click New Web Service, and connect this repository.
2. Under "Root Directory", type: backend
3. Under "Build Command", type: pip install -r requirements.txt
4. Under "Start Command", type: uvicorn app.main:app --host 0.0.0.0 --port $PORT
5. Select the Free instance type and deploy. Copy your live backend URL.

Deploying the Frontend (Vercel)

1. Go to Vercel, click Add New Project, and import this repository.
2. In the "Build and Output Settings", change the Root Directory to frontend.
3. Open the Environment Variables tab. Add a variable named VITE_API_URL and paste the backend URL from Render (e.g., https://ai-code-scanner-api.onrender.com).
4. Hit Deploy. The UI routing will be handled automatically by the included vercel.json file.

---

Engineered with precision for secure deployment environments.