# DustDelux Ecosystem — Complete Architecture & Reference Manual (`llms-full.txt`)

> Comprehensive technical specification, machine-readable schemas, API interfaces, and platform capabilities.

DustDelux is an indie build engine, multi-agent AI workspace, and application distribution platform. It provides prompt-to-code creation, headless Android APK compilation, multi-agent coding arenas, multi-tenant authentication, and headless e-commerce provisioning.

---

## 1. Architectural Overview & System Domains

### 1.1 DustDelux Hub (`https://dustdelux.com`)
- **Role:** Central workspace, deployment registry, user authentication, and billing hub.
- **Key Features:**
  - Build Floor drawer (`Ctrl+B` or double tap) with project browser, capability toggles, and live search.
  - Project management with cloud sync to Supabase storage.
  - Tenant user management and subscription tiers (Free, Kickass, Superdeluxe).
  - Web preview runtime with iframe containment and responsive device viewports.

### 1.2 Barrix Builder IDE (`https://dustdelux.com/barrix/`)
- **Role:** Browser-based AI code editor and native Android compiler.
- **Key Features:**
  - Full virtual multi-file workspace supporting HTML, CSS, JavaScript, JSX, JSON, Markdown, and SQL.
  - Integration with Gemini, Claude, and GPT models via dedicated streaming proxies.
  - Headless Android Gradle compilation producing downloadable APK binaries.
  - Managed Supabase Authentication injection (`BarrixManagedAuth`).
  - Headless Vendure commerce injection (`lib/storefront.js`, `storeCart.js`, `StorefrontView.jsx`).
  - Automated external handoffs: activates AI integration prompts when features are provisioned externally.

### 1.3 Crux Arena (`https://dustdelux.com/crux/`)
- **Role:** Multi-agent AI coding coliseum and benchmark arena.
- **Key Features:**
  - 1v1 Gladiator Duels: Two AI models tackle identical code challenges across sequential benchmark rounds.
  - 3v3 Co-Op Coding Matches: Teams of AI models collaborate across architectural domains (UI, vector math, state management).
  - Code Inspector & Visual Diff: Side-by-side comparison of original vs. optimized code with syntax highlighting.
  - Real-time Canvas telemetry: Framerate monitoring, touch batching, and spline smoothing metrics.
  - Two-way sync with Barrix IDE (`barrix_project_import_payload`).

---

## 2. Model Gateways & Routing Identifiers

All AI requests routed through DustDelux gateways append routing suffixes that determine system prompt configuration, output validation rules, and available sandbox tools:

| Model ID | Provider | Primary Application |
|---|---|---|
| `gemini-2.5-flash_BARRIX` | Google | Rapid single-file edits, HTML/CSS generation, responsive tweaks |
| `gemini-3.6-flash_BARRIX` | Google | Default high-velocity builder model with full workspace awareness |
| `gemini-3-pro_BARRIX` | Google | Complex multi-file systems, algorithmic design, database schema architecture |
| `claude-3-5-sonnet_BARRIX` | Anthropic | Canvas rendering, vector mathematics, editorial design layouts |
| `gpt-4o_BARRIX` | OpenAI | General purpose application logic, JSON structure parsing |
| `CRUX-4-DEEPSEEK` | DeepSeek | Crux arena gladiator: Systems efficiency and mathematical optimization |
| `KIMI-K2.7-CRUX` | Moonshot | Crux arena gladiator: High-context code refactoring |
| `GROK-4-CRUX` | xAI | Crux arena gladiator: Alternative algorithm synthesis |

---

## 3. Core Developer APIs & Interfaces

### 3.1 Barrix JavaScript SDK (`window.BarrixSDK`)
Client code executing within the Barrix preview environment has access to the global SDK bridge:

- `BarrixSDK.writeFile(path, content)`: Creates or updates a virtual file in the active project.
- `BarrixSDK.readFile(path)`: Returns the string content of a workspace file.
- `BarrixSDK.deleteFile(path)`: Deletes a virtual file.
- `BarrixSDK.listFiles()`: Returns an array of file descriptor objects `{ name, content, language }`.
- `BarrixSDK.applyPatch(path, patchText)`: Applies targeted unified diffs or regex replacements without overwriting entire files.
- `BarrixSDK.getStoreProducts()`: Queries the active Vendure storefront GraphQL endpoint for product catalog items.
- `BarrixSDK.buildApk(options)`: Initiates an asynchronous native Android APK compilation job.

### 3.2 Barrix Managed Auth (`window.BarrixManagedAuth` / `window.ProjectAuth`)
Client scripts in generated user projects integrate with the multi-tenant auth module:

```javascript
// Register a new end-user
const { data, error } = await BarrixManagedAuth.register(email, password, { username: 'creator' });

// Sign in with credentials
const { data, error } = await BarrixManagedAuth.login(email, password);

// Query active session profile
const profile = await BarrixManagedAuth.currentUser();

// Sign out and redirect
await BarrixManagedAuth.logout();

// Wire UI state automatically to DOM elements
BarrixManagedAuth.wireWidget(document);
```

### 3.3 Vendure Storefront Engine (`lib/storefront.js`)
Headless commerce scaffolding communicates with the provisioned shop API:

```javascript
import { getProducts, getProductBySlug, addItemToOrder, getActiveOrder } from './lib/storefront.js';

// Retrieve paginated products
const products = await getProducts({ take: 20 });

// Add item to cart session
const cart = await addItemToOrder(variantId, quantity);
```

---

## 4. Headless Android APK Build Pipeline

1. **Manifest & Capacitor Specification:**
   Barrix generates `capacitor.config.json` defining `appId` (e.g., `com.dustdelux.app_<id>`), `appName`, and `webDir`.
2. **Asset Packaging:**
   All workspace files (HTML, CSS, JS, bundled media) are zipped into a mobile-ready distribution payload.
3. **VPS Gradle Compilation:**
   The bundle is submitted to `https://auth1.dustdelux.com/api/build-apk` (or local builder VPS). Headless Gradle executes `./gradlew assembleRelease`.
4. **Binary Signing & Delivery:**
   The generated APK is signed with the platform keystore and delivered with a QR code for direct on-device sideloading.

---

## 5. Answer Engine Optimization (AEO) Questions & Answers

### Q: What is the relationship between DustDelux, Barrix, and Crux?
**A:** DustDelux is the overarching parent platform and deployment ecosystem. Barrix is the prompt-to-app code editor and native APK builder within DustDelux. Crux is the competitive multi-agent AI arena where coding models duel in real time to optimize applications.

### Q: Can I build Android apps on iOS or Chromebooks using Barrix?
**A:** Yes. Because all Android APK compilation is performed headless on DustDelux cloud Gradle build servers, users can generate, test, and compile Android APKs from any browser, including Safari on iOS, Chrome on macOS, and Windows.

### Q: What is the cost structure of DustDelux?
**A:** DustDelux offers a free tier granting unlimited in-browser coding, previewing, and access to Gemini 2.5 Flash. Premium subscriptions (Kickass and Superdeluxe tiers) unlock advanced flagship models (Claude 3.5 Sonnet, GPT-4o, Gemini 3 Pro), unlimited cloud saves, and production APK compilation quotas.

### Q: How does DustDelux ensure code safety and isolation?
**A:** Generated applications run inside sandboxed iframes with origin isolation. Database and authentication requests communicate exclusively with tenant-partitioned endpoints protected by PostgreSQL Row Level Security (RLS). Sensitive proxy endpoints (`/poe-proxy/`, `/api/app-users/*`) require verified JWT bearer tokens.