📘 THE AI HANDBOOK

1. The "Magical Triad"

To bring legacy FWH desktop apps to the web, the community established a powerful combination of three components:

• HIX (by Carles Aubia): The robust backend framework for web connectivity.
• Google AntiGravity: An AI-powered engine (released 2025) acting as a bridge to transform desktop logic into web structures.
• Gemini 3 / Claude 4.5: The underlying logic engines for "Vibe Coding" and automated generation.

2. Installation & Setup

According to Antonio Linares, these are the essential steps to start your migration:

1. Install HIX: Download from GitHub and place it in a local directory (e.g., C:\hix).
2. Install AntiGravity: Access via the official portal at antigravity.google.
3. Pattern Sync: Copy the provided HIX + AntiGravity samples into your HIX folder to give the AI a baseline.

3. Taming Hallucinations & Scopes

Expert TimStone highlights a critical AI weakness: mixing up variable scopes and names.

• Manual Revision: Always check generated code for consistent variable naming.
• Scope Guard: Tell the AI: "Keep object references strictly within the provided class scope."

4. The "Context-Injection" Method

Antonio Linares emphasizes that the key to high-quality code is Context. Since public FiveWin training data is sparse, you must provide your own.

• Feed Patterns: Provide the AI with FWH/samples directly.
• No Limits: Even heavily modified classes like TSBrowse can be migrated because AntiGravity abstracts the underlying logic rather than just translating commands.

5. Architecture & Modernization

Otto explains that modularity (the Harbourino approach) is a massive AI accelerator.

• Modular Blocks: Small, separated code blocks are handled much more reliably by AI than monolithic PRG files.
• Infrastructure: Use Redis (via Docker) to cache AI tokens and speed up the response cycle.
• Deployment: Cloudflare is currently the most efficient way to deploy the resulting HIX web apps.

6. Practical Code Examples

Snippet of a HIX/AntiGravity bridge logic (calculator.prg):

// Basic Web Logic Bridge
function Main()
   local hPost := UPost() // Fetches web parameters
   local cHtml := ""
   local nNum1, nNum2

   if hb_HHasKey( hPost, "num1" )
      nNum1 := Val( hPost["num1"] )
      // ... process logic here
   endif
return cHtml

A Sudoku app was fully migrated using this method in only 27 minutes!