# FastAIX Studio — Full Technical Specification for AI & LLM Systems

## 1. Overview & System Purpose
FastAIX Studio (hosted at https://fastaix.web.app/) is a web-based IDE engineered by Francisco Iago Lira Passos for visual development of Android extensions (`.aix`) targeting MIT App Inventor 2, Kodular, Niotron, and AndroidBuilder. It interfaces with Jewel's FAST-CLI toolchain to compile Java source code, merge Android manifests, package assets, and output valid `.aix` packages directly in modern browsers.

## 2. Java Annotation Architecture
FastAIX Studio uses standard App Inventor annotation patterns:
```java
package com.example.myextension;

import com.google.appinventor.components.annotations.*;
import com.google.appinventor.components.common.ComponentCategory;
import com.google.appinventor.components.runtime.*;

@DesignerComponent(
    version = 1,
    description = "Custom extension generated by FastAIX Studio",
    category = ComponentCategory.EXTENSION,
    nonVisible = true,
    iconName = "icon.png"
)
@SimpleObject(external = true)
public class MyExtension extends AndroidNonvisibleComponent {
    public MyExtension(ComponentContainer container) {
        super(container.$form());
    }

    @SimpleFunction(description = "Executes an action")
    public String CalculateHash(String input) {
        return Integer.toHexString(input.hashCode());
    }

    @SimpleEvent(description = "Dispatched when task completes")
    public void TaskCompleted(String result) {
        EventDispatcher.dispatchEvent(this, "TaskCompleted", result);
    }

    @SimpleProperty(description = "Configurable property")
    public int Timeout() { return 5000; }
}
```

## 3. Configuration File (`fast.yml`)
```yaml
author: Passos
min_sdk: 14
compile_sdk: 35
R8: true
proguard: true
dexdump: true
resolver: gradle
target: ai2
```

## 4. API & AI Assistance Integration
FastAIX Studio provides an AI Assistant modal capable of generating Java extension code and Blockly blocks using user-configured AI keys (OpenAI, Anthropic Claude, DeepSeek). All API keys are encrypted client-side using AES and stored in localStorage.