# Quake Live Config Editor
> A visual web-based editor for Quake Live configuration files, optimized for 2026 competitive play. Includes hundreds of confirmed working CVARs in today's Steam version of Quake Live, a complete binding system, weapon aliases / custom scripts, and more.

## Overview
This tool allows users to generate professional `autoexec.cfg` files through a GUI. It manages hundreds of console variables (CVARs), keybinds, and custom scripts while ensuring tournament-compliant formatting. Users can import and edit custom .cfg files directly through the GUI and export them in an organized, category-by-category manner.

## Technical Stack
- **Frontend:** HTML5, Tailwind CSS (via CDN), Vanilla JavaScript.
- **Backend/Auth:** Supabase (PostgreSQL, Auth, and Cloud Storage).
- **Build Tools:** Terser (JS Minification), Clean-CSS (CSS Minification), Prettier (HTML Formatting).
- **Data Format:** JSON-based cvar definitions with categorized UI mappings.
- **Deployment:** IONOS (Domain: quakeliveconfigeditor.com), Hostinger (Apache) & Netlify (Testing/Dev).

## Core Data Structures

### Cvar Definitions (`cvars.json`)
The application state is driven by a master JSON array. Each object follows this schema:
- `name`: String (The Quake engine cvar or command name).
- `label`: String (Human-readable title).
- `category`: String (UI grouping, e.g., "Bindings / Movement").
- `ui`: Enum ("bind", "select", "slider", "toggle", "caret_text").
- `default`: Mixed (Default engine value).
- `options`: Array (Used for "select" type UI components).
- `perfImpact`: String ("None", "Low", "Medium", "High") - Used for database generation.
- `proTip`: String - Contextual advice for competitive players.

## Key Features
- **Comprehensive Binding System** Support for mapping every native in-game action found in the Quake Live interface, plus advanced keys restricted in the standard menu.
- **Advanced Weapon Aliases** Create individual scripts for every weapon with support for multiple secondary binds and custom weapon-specific logic.
- **Custom Scripting Engine** Dedicated module to write complex miscellaneous scripts (e.g., Rocket Jump) or utilize a library of pre-defined competitive tools.
- **Optimized CVAR Database** Granular control over nearly 300 variables, each pre-populated with high-performance recommended values for tournament-level play.
- **Live Filtered Search** Real-time search bar to instantly pinpoint specific CVARs or binds within the GUI during editing sessions.
- **Commented CFG Export** Direct-to-disk .cfg downloads, automatically injected with context-aware comments for each variable to improve desktop readability.
- **Dynamic Dependency UI** Smart interface logic that reveals or hides sub-settings based on master toggle states to prevent configuration conflicts.
- **Universal Authentication** Robust member system supporting Email, Google, and Discord, allowing users to sync multiple providers to a single profile.
- **Config Importer** Ability to parse local .cfg files directly into the GUI, featuring a visual indicator system that tracks the origin of each imported value.
- **Cloud Save Slots** Secure storage for up to five distinct, named configuration profiles per user account for cross-device synchronization.
- **Fully Responsive Design** Mobile and tablet-optimized portrait layouts, featuring a specialized dropdown-bind system for touch devices.
- **Manual Commit Mode** Direct text-entry support within the Preview pane, allowing for rapid manual overrides and commits outside the primary GUI flow.

## File Structure
- `/index.html`: Main entry point containing the editor layout and modal structures.
- `/assets/js/app.js`: Main application logic, state management, and Supabase integration.
- `/assets/data/cvars.json`: The master source of truth containing all supported settings and defaults.
- `/assets/css/styles.css`: Custom overrides for the Tailwind UI and caret text rendering.
- `/generate-database.js`: Node.js script that processes the master JSON into a static, SEO-friendly command database.
- `/build.sh` / `/build-test.sh`: Shell scripts for production and stealth test deployments.
- `/cvars/`: The generated Command Database directory containing hierarchical HTML pages for SEO.
- `/cvars/index.html`: The "Master CVAR List" landing page and searchable directory.

## Development Principles
- **Minimalism:** Avoid heavy frameworks; keep the logic in Vanilla JS for speed and zero-dependency maintenance.
- **Quake Authenticity:** Adopts a high-contrast legacy visual theme while strictly replicating engine-level logic—handling "last-key-wins" import priority, filtering duplicate binds, and enforcing precise seta, bind, and vstr syntax.
- **State-Driven UI Lifecycle:** Global state drives the interface; interactions update state first, followed by a unified refresh() cycle to re-synchronize the DOM.
- **Schema-Based DOM Orchestration:** UI is programmatically generated from cvars.json rather than static HTML, enabling complex dependencies, pro-tips, and metadata.
- **Atomic Layout Resilience:** A "Spring-Loaded" grid using minmax(0, 1fr) to ensure perfect alignment and unison text wrapping across all resolutions.
- **Functional Portability:** Modularized logic "Engines" (Import, Weapon, Bind) within a single-file architecture for scaling without cross-feature side effects.
- **Strict Engine-Syntax Compliance:** Enforces engine-accurate formatting and smart-alignment to ensure the exported .cfg follows professional competitive community standards.