⚓ HarbourBuilder

The Most Powerful Cross-Platform Visual IDE for Harbour

Design visually. Code in Harbour. Run natively on every platform.

Quick Start · Features · Screenshots · Documentation · Tutorials · Contributing

---

What is HarbourBuilder?

HarbourBuilder is a Borland C++Builder-style visual IDE that generates Harbour/xBase code. Drop controls from the palette, set properties in the inspector, double-click to write event handlers — and your app runs natively on Windows, macOS, and Linux with zero code changes.

Windows

macOS

Linux

---

📱 NEW — Now going Mobile

Drop controls. Hit Run. See your app on Android.

 

The same Harbour source that drives Windows, macOS and Linux desktops now produces a signed APK running on the Android emulator — with native android.widget.Button, TextView, EditText. No web view. No skinned UI. No runtime dependency.

Architecture

Your .prg          DEFINE FORM ... BUTTON ... EDIT ...
    │
    ▼
classes.prg   →    UI_FormNew() · UI_ButtonNew() · UI_EditNew() · UI_OnClick() ...
    │
    ├──▶  hbbridge.cpp     →  Windows   (Win32 CreateWindowEx)
    ├──▶  cocoa_core.m     →  macOS     (NSView hierarchy)
    ├──▶  gtk3_core.c      →  Linux     (GtkWidget)
    ├──▶  android_core.c   →  Android   (JNI → android.widget.*)   ◀── NEW
    └──▶  ios_core.m       →  iOS       (UIKit / UIView)           ◀── SOON

What works today (Iteration 1)

• ✅ Harbour cross-compiled for ARM64 — 30 static libraries built against official harbour/core sources with NDK Clang, zero source changes
• ✅ End-to-end build pipeline — 8 stages: harbour → clang → aapt2 → javac → d8 → zipalign → apksigner
• ✅ One-click build from the IDE — menu Run → Run on Android... invokes the full pipeline, signs the APK and launches the emulator
• ✅ Native GUI backend — UI_FormNew, UI_LabelNew, UI_ButtonNew, UI_EditNew, UI_SetText, UI_GetText, UI_OnClick, UI_SetFormColor, UI_SetCtrlColor, UI_SetCtrlFont wired via JNI
• ✅ Density-aware layout — form-designer coordinates scale by DisplayMetrics.density so a 100-px button looks consistent on mdpi, hdpi, and xxhdpi screens
• ✅ IDE form designer → Android APK — drop controls, hit Run → Run on Android..., the IDE generates the UI_* code, builds a signed APK, boots the emulator, installs and launches — colors and fonts included
• ✅ Setup Wizard — menu Run → Android Setup Wizard... detects NDK, SDK, JDK, AVD, Harbour-for-Android libs; one click downloads + installs the ~2.8 GB toolchain
• ✅ Prebuilt Harbour-for-Android shipped in the repo (releases/harbour-android-arm64-v8a.zip, 3.6 MB) — no need to cross-compile Harbour from source; the wizard just extracts it
• ✅ Validated on Pixel 5 / Android 14 — AVD HarbourBuilderAVD, Harbour VM initialized, PRG Main() executed, widgets rendered, click events dispatched back to Harbour codeblocks

Coming next

• 🚧 ComboBox, ListView, RadioButton, CheckBox, DatePicker
• 🚧 Embedded adb logcat panel in the IDE (today it streams in a dedicated terminal window)
• 🚧 Device picker (emulator / USB / Wi-Fi ADB)
• 🚧 Keystore manager + release AAB export for Play Store
• 🚧 Setup Wizard port to macOS and Linux hosts
• 🚧 Multi-ABI prebuilts (x86_64, armeabi-v7a) in addition to the current arm64-v8a

Why this matters

No other Harbour IDE — classic or modern — targets mobile natively. HarbourBuilder is about to let tens of thousands of Harbour developers ship to every platform that matters from a single codebase.

iOS — coming soon

The iOS backend mirrors the Cocoa architecture we already ship on macOS: UIView instead of NSView, touch events instead of mouse, Xcode toolchain instead of clang. The same Harbour classes that target five desktops will soon also compile to a signed .ipa, ready for TestFlight and the App Store. Five platforms. One source. Harbour everywhere.

---

What you write:

#include "hbbuilder.ch"

function Main()
   local oForm, oBtn

   DEFINE FORM oForm TITLE "Hello World" SIZE 400, 300 FONT "Segoe UI", 10

   @ 120, 140 BUTTON oBtn PROMPT "Click Me!" OF oForm SIZE 120, 32
   oBtn:OnClick := { || MsgInfo( "Hello from HarbourBuilder!" ) }

   ACTIVATE FORM oForm CENTERED
return nil

What the IDE generates (two-way code sync from the visual designer):

// Form1.prg

CLASS TForm1 FROM TForm

   // IDE-managed Components

   // Event handlers

   METHOD CreateForm()

ENDCLASS

METHOD CreateForm() CLASS TForm1
   ::Title  := "Form1"
   ::Left   := 100
   ::Top    := 170
   ::Width  := 400
   ::Height := 300
return nil

Both styles run identically on Windows, macOS, and Linux — with native controls on each platform.

---

✨ Features

🎨 Visual Form Designer

• WYSIWYG form designer with dot grid and snap
• Drag & drop from component palette
• Selection handles with rubber band multi-select
• Copy/Paste controls (Cmd/Ctrl+C/V with +16px offset)
• Align & Distribute (Format menu: Left/Right/Top/Bottom, Center, Space Evenly)
• Real-time two-way tools: design ↔ code sync

📦 130 Components in 16 Tabs

Tab	Controls	Description
Standard	11	Label, Edit, Memo, Button, CheckBox, RadioButton, ListBox, ComboBox, GroupBox, Panel, ScrollBar
Additional	10	BitBtn, SpeedButton, Image, Shape, Bevel, MaskEdit, StringGrid, ScrollBox, StaticText, LabeledEdit
Native	9	TabControl, TreeView, ListView, ProgressBar, RichEdit, TrackBar, UpDown, DateTimePicker, MonthCalendar
System	2	Timer, PaintBox
Dialogs	6	OpenDialog, SaveDialog, FontDialog, ColorDialog, FindDialog, ReplaceDialog
Data Access	9	DBF, MySQL, MariaDB, PostgreSQL, SQLite, Firebird, SQLServer, Oracle, MongoDB
Data Controls	8	TBrowse, DBGrid, DBNavigator, DBText, DBEdit, DBComboBox, DBCheckBox, DBImage
Printing	8	Printer, Report, Labels, PrintPreview, PageSetup, PrintDialog, ReportViewer, BarcodePrinter
Internet	9	WebView, WebServer, WebSocket, HttpClient, FtpClient, SmtpClient, TcpServer, TcpClient, UdpSocket
ERP	12	Preprocessor, ScriptEngine, ReportDesigner, Barcode, PDFGenerator, ExcelExport, AuditLog, Permissions, Currency, TaxEngine, Dashboard, Scheduler
Threading	8	Thread, Mutex, Semaphore, CriticalSection, ThreadPool, AtomicInt, CondVar, Channel
AI	9	OpenAI, Gemini, Claude, DeepSeek, Grok, Ollama, Transformer, Whisper, Embeddings
Connectivity	9	Python, Swift, Go, Node, Rust, Java, DotNet, Lua, Ruby
Git	10	GitRepo, GitCommit, GitBranch, GitLog, GitDiff, GitRemote, GitStash, GitTag, GitBlame, GitMerge

🔀 Git Integration (Source Control)

Full Git support built into the IDE — no external tools needed:

• Source Control panel (Git > Status): branch label, staged/unstaged changes ListView, commit message editor, action buttons (Refresh/Commit/Push/Pull/Stash)
• Git menu (17 items): Init, Clone, Status, Commit, Push, Pull, Branch Create/Switch/Merge, Stash/Pop, Log, Diff, Blame
• 11 backend functions wrapping git.exe CLI via CreateProcess with stdout capture:
  • GIT_Status() — parses --porcelain into { { cStatus, cFile }, ... }
  • GIT_Log() — parses --format into { { cHash, cAuthor, cDate, cMsg }, ... }
  • GIT_Diff(), GIT_Blame(), GIT_CurrentBranch(), GIT_BranchList()
  • GIT_Exec() — run any git command and capture output
  • GIT_IsRepo(), GIT_RemoteList(), GIT_StashList()
• Branch switching with list dialog (Git > Branch > Switch)
• Dark-themed panel matching VS Code Source Control style

🔌 Connectivity (Language Interop)

Call any language from Harbour — or embed Harbour in any language:

Component	Mechanism	Use Case
Python	C API (Py_Initialize, PyRun_SimpleString)	AI/ML (TensorFlow, PyTorch), data science (pandas, numpy), scripting
Swift	Bridging header + @objc interop	Native macOS/iOS APIs, SwiftUI, Apple frameworks
Go	cgo FFI (import "C")	Microservices, CLI tools, high-concurrency backends
Node	child_process / N-API addon	npm ecosystem, Electron UIs, REST APIs, real-time (Socket.io)
Rust	C ABI (extern "C" + #[no_mangle])	Performance-critical code, WASM compilation, safe systems
Java	JNI (JNI_CreateJavaVM)	Enterprise (Spring, JDBC), Android apps, cross-platform libs
DotNet	COM Interop / CLR hosting	Windows enterprise (.NET, WPF, Entity Framework), C# libraries
Lua	lua_State embedding (< 300KB)	User scripting, plugin systems, game logic, config files
Ruby	C extension API (rb_define_method)	DSLs, web (Rails), DevOps (Chef, Vagrant), text processing

Each component wraps the target language's C-level embedding/FFI API, letting you call functions, pass data, and receive results without leaving Harbour.

🔍 Object Inspector

• Properties tab with categorized grid (Appearance, Position, Behavior, Data)
• Events tab with dynamic event list per control type (UI_GETALLEVENTS)
• Dropdown editors for enum properties (BorderStyle, Position, WindowState, FormStyle, Cursor)
• Double-click event → auto-generate handler code
• Color picker, font picker, inline editing
• ComboBox selector for all form controls

💻 Code Editor (Scintilla — all 3 platforms)

• Scintilla 5.5+ editor on all platforms (same engine as Notepad++, SciTE, Code::Blocks)
  • Windows: Scintilla.dll + Lexilla.dll (dynamic)
  • macOS: libscintilla.a + liblexilla.a (static, compiled from source)
  • Linux: libscintilla.so + liblexilla.so (dynamic)
• VS Code Dark+ color theme with Harbour-aware syntax highlighting
• Keywords (blue, bold), commands (teal), comments (green, italic), strings (orange), numbers (light green), preprocessor (magenta)
• Built-in line numbers, code folding, and indentation guides
• Harbour-aware folding: function/return, class/endclass, if/endif, for/next, do/enddo, switch/endswitch, begin/end, #pragma begindump/enddump
• Ctrl+F / Cmd+F Find bar, Ctrl+H / Cmd+H Replace bar
• Ctrl+Space / Cmd+Space Auto-completion (150+ Harbour keywords, functions, xBase commands)
• Ctrl+/ / Cmd+/ Toggle line comment
• Ctrl+Shift+D / Cmd+Shift+D Duplicate line
• Ctrl+Shift+K / Cmd+Shift+K Delete line
• Ctrl+L / Cmd+L Select line
• Ctrl+G / Cmd+G Go to line
• F12 Go to definition (function/procedure/method/class)
• Bracket matching — (), [], {} highlighted yellow, bad brackets red
• Bookmarks — Cmd/Ctrl+0..9 toggle, Cmd/Ctrl+Shift+0..9 jump
• Code snippets — Tab expansion: forn, iff, cls, func, proc, whil, swit, tryx
• Auto-indent on Enter (preserves previous line indentation)
• Tabbed editor (Project1.prg + Form tabs)
• Build messages panel — clickable errors, jump to line, red markers
• Status bar: Line, Column, INS/OVR, line count, char count, UTF-8

🤖 Built-in AI Assistant

• Ollama integration — local AI, no API keys, fully private
• Model selector: codellama, llama3, deepseek-coder, mistral, phi3, gemma2
• Chat interface with code suggestions
• Also supports LM Studio (OpenAI-compatible API)
• Future: inline code completion (Copilot-style)

🐛 Integrated Debugger (runs inside the IDE)

• In-process debugging — user code executes inside the IDE's Harbour VM via .hrb bytecode
• Harbour VM hook (hb_dbg_SetEntry) intercepts every source line
• Execution pauses at breakpoints or step commands while the IDE stays responsive
• Professional debug toolbar: ▶ Run, ⏸ Pause, ↓ Step Into, → Step Over, ■ Stop
• 5 dockable tabs (bottom, Lazarus/C++Builder style):
  • Watch — evaluate expressions in the current scope
  • Locals — auto-populated with local variable Name, Value, Type (via hb_dbg_vmVarLGet)
  • Call Stack — full stack trace with Level, Function, Module, Line
  • Breakpoints — list with File, Line, Enabled status
  • Output — real-time debug log (pause points, session start/end)
• Compile to .hrb: harbour -gh -b produces portable bytecode with debug info
• Load and execute: hb_hrbRun() runs user code in the IDE's own VM
• Event loop during pause: GTK gtk_main_iteration() / Win32 PeekMessage loop / Cocoa run loop keeps UI responsive while debugger waits
• Toggle/Clear breakpoints from Run menu
• Dark themed with monospace fonts and resizable columns
• 16 unit tests covering state machine, breakpoints, HRB compilation, execution, and variable inspection — all passing

Technical note: HRB pcode execution does not trigger hb_dbg_SetEntry hooks — the Harbour VM only fires debug callbacks for natively compiled code (.prg → .c → .o). Current approach: the debugger engine, panel UI, breakpoint manager, and variable inspector are fully implemented and tested. Next step: a pipe-based debug agent compiled into the user's executable that communicates with the IDE via Unix socket, enabling full step-through debugging with compiled code.

🌙 Dark Mode (all platforms)

• Windows: dark title bars via DwmSetWindowAttribute
• macOS: NSAppearanceNameDarkAqua applied app-wide on startup
• Linux: gtk-application-prefer-dark-theme toggle
• Dark code editor and documentation theme

📊 Visual Report Designer (all platforms)

• Visual band/field editor with mouse interaction (drag fields, resize bands)
  • Windows: GDI rendering | Linux: Cairo | macOS: Core Graphics
• Report Preview with zoom (25%-400%), page navigation (First/Prev/Next/Last)
• TReport container with band management and code generation
• TReportBand: Title, Header, Detail, Group, Footer, Summary bands
  • Properties: height, visibility, colors, repeat on page, group expression
• TReportField: text, field, expression, image, barcode, line, box, shape
  • Properties: position, size, font, colors, alignment, format
• Inspector integration: edit band/field properties live
• GenerateCode(): produces complete Harbour CLASS source from design
• xCommand macros: DEFINE REPORT, DEFINE BAND, REPORT TEXT/DATA
• Unit tested (49 tests, all passing)

📋 Project Management

• New Application / Open / Save / Save As projects (.hbp files)
• Multi-form support (Form1, Form2, Form3...)
• Add to Project (import .prg files) / Remove from Project
• Install Component / New Component (template generator)
• Project Inspector tree view
• Project Options dialog (Harbour / C Compiler / Linker / Directories)
• Editor Colors dialog with presets (Dark, Light, Monokai, Solarized)
• Full clipboard: Cut / Copy / Paste / Undo / Redo via Scintilla
• Multi-compiler support: auto-detects MSVC (2019/2022/Community/BuildTools) and BCC
• Tools > Select Compiler: choose between all detected compilers, shown in title bar
• Smart rebuild: hash-based skip when code + compiler unchanged
• Progress dialog: 7-step build progress with status text
• Build error dialog: resizable, selectable text, Copy to Clipboard button
• Build & Run with F9, Debug with in-process .hrb execution
• Database verified: DBF (native RDD) + SQLite (hbsqlit3) working on all platforms

🗄️ Database Components (tested and verified)

Unified TDatabase architecture — switch backends by changing one line:

// All backends share the same API:
oDb := TSQLite():New()              // or TDBFTable(), TMySQL(), TPostgreSQL()...
oDb:cDatabase := "myapp.sqlite"
oDb:Open()
oDb:Execute( "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)" )
oDb:Execute( "INSERT INTO users VALUES (1, 'Alice')" )
aRows := oDb:Query( "SELECT * FROM users" )
oDb:Close()

Component	Status	Description
TDBFTable	✅ Tested	Native DBF/NTX/CDX — GoTop, Skip, Seek, Append, Delete, FieldGet/Put, Structure, CreateIndex (20+ methods)
TSQLite	✅ Tested	SQLite3 — Execute, Query, CreateTable, BeginTransaction, Commit, Rollback, LastInsertId, Tables, TableExists
TMySQL	🔧 Stub	Needs apt install libmysqlclient-dev
TMariaDB	🔧 Stub	Wire-compatible with MySQL (inherits TMySQL)
TPostgreSQL	🔧 Stub	Needs apt install libpq-dev
TFirebird	🔧 Stub	Needs apt install firebird-dev
TSQLServer	🔧 Stub	Needs apt install freetds-dev
TOracle	🔧 Stub	Needs Oracle Instant Client
TMongoDB	🔧 Stub	Needs apt install libmongoc-dev

Data Controls (visual, bind to any TDatabase):

• TDataSource — binds database to controls (MoveFirst/Prev/Next/Last/Append/Delete)
• TDBGrid — scrollable data table (GtkTreeView / Win32 ListView)
• TDBNavigator — navigation buttons (|< < > >| + - v)
• TDBEdit, TDBText, TDBComboBox, TDBCheckBox, TDBImage

4 sample projects in samples/projects/database/:

• dbf_example.prg — DBF CRUD operations
• sqlite_example.prg — SQL tables, transactions, queries
• portable_example.prg — same API across all backends
• datacontrols_example.prg — TDataSource + TDBNavigator binding

---

---

🏗️ Architecture

Application Code (.prg)
  → xBase Commands (hbbuilder.ch — compile-time, zero cost)
    → Harbour OOP (classes.prg — thin ACCESS/ASSIGN wrappers)
      → HB_FUNC Bridge (identical interface on all platforms)
        → Native Backend
           ├── Win32 API (C++ — CreateWindowEx, GDI, Scintilla)
           ├── Cocoa/AppKit (Objective-C — NSView, NSButton)
           └── GTK3 (C — GtkWidget, GtkFixed, Scintilla, Cairo)

Debugger Architecture

Run > Debug:
  user.prg ──harbour -gh -b──→ user.hrb (bytecode + debug info)
                                   │
  IDE VM ─── hb_hrbRun() ─────────┘
    │
    ├─ hb_dbg_SetEntry(hook) ──→ VM calls hook on every line
    │                               │
    │                          ┌────┴────────────────────┐
    │                          │ Update Locals/Call Stack │
    │                          │ Highlight current line   │
    │                          │ while(paused)            │
    │                          │   gtk_main_iteration()   │
    │                          │ ← Step/Go/Stop button    │
    │                          └──────────────────────────┘
    │
    └─ User code continues...

Performance

Benchmark	FiveWin	HarbourBuilder	Speedup
Create 500 buttons	0.243s	0.001s	243×
Set property 100K×	24.86s	0.07s	355×

---

🚀 Quick Start

Windows

build_win.bat

macOS

Prerequisites:

1. Install Xcode Command Line Tools: xcode-select --install
2. That's it! Harbour and Scintilla are downloaded and built automatically

cd samples
./build_mac.sh        # builds HbBuilder (auto-downloads Harbour + Scintilla on first run)
cp HbBuilder ../bin/  # copy to bin/
../bin/HbBuilder      # run

On first run, the build script will:

• Clone and compile Harbour to ~/harbour (if not found)
• Build Scintilla 5.5.3 + Lexilla static libraries from source

To use a custom Harbour installation: HBDIR=/path/to/harbour ./build_mac.sh

Apple Silicon (M1/M2/M3/M4): The current build produces x86_64 binaries which run via Rosetta 2 on ARM Macs. For native ARM builds, recompile Harbour for darwin/clang/arm64 and update HBDIR in build_mac.sh.

Linux

cd samples
./build_gtk.sh

Requirements

• Harbour 3.2 compiler
• Windows: BCC 7.7 (free) or MSVC
• macOS: Xcode Command Line Tools (xcode-select --install)
• Linux: GCC + GTK3 dev (apt install libgtk-3-dev)

---

📚 Documentation

Professional HTML documentation with dark/light theme, Mermaid diagrams, and code examples:

Page	Description
Overview	Introduction + architecture diagram
Quick Start	5-step getting started guide
Architecture	5-layer arch + 7 Mermaid diagrams
Controls Reference
Standard	Label, Edit, Button, CheckBox... (11)
Additional	BitBtn, Image, Shape... (10)
Native	TreeView, ListView, DatePicker... (9)
Data Access	MySQL, PostgreSQL, SQLite... (9)
Data Controls	TBrowse, DBGrid, DBNavigator... (8)
Internet	WebServer, WebSocket, TCP... (9)
Threading	Thread, Mutex, Channel... (8)
AI	OpenAI, Ollama, Transformer, Whisper, Embeddings... (9)
Connectivity	Python, Swift, Go, Node, Rust, Java, DotNet, Lua, Ruby (9)
Git	GitRepo, GitCommit, GitBranch, GitLog, GitDiff, GitRemote... (10)
ERP	Report, Barcode, PDF... (12)

---

📖 Tutorials

Tutorial	What you'll build
Hello World	Your first form with a button
Working with Forms	Multi-form app with ShowModal
Event Handling	OnClick, OnChange, OnKeyDown
Database CRUD	SQLite + TBrowse data browser
Web Server	TODO app with TWebServer
AI Integration	Ollama chat + Transformer

Transformer Examples

7 didactic examples in samples/projects/transformer/:

• attention_visualizer.prg — Attention weight heatmap
• text_generator.prg — Autoregressive generation with temperature
• train_from_scratch.prg — Training loop with loss curve
• tokenizer_explorer.prg — Interactive BPE tokenization
• attention_is_all_you_need.prg — Full paper walkthrough
• sentiment_analyzer.prg — BERT-style classification
• translator_demo.prg — Encoder-decoder translation

---

🖥️ Platforms

All three desktop platforms are fully functional with zero MsgInfo stubs — every menu item, toolbar button, and dialog is implemented with native controls.

Platform	Backend	Status
Windows	Win32 API (C++) + Scintilla 5.6.1 DLL	✅ Full IDE
Linux	GTK3 (C) + Scintilla 5.6.1 shared lib	✅ Full IDE
macOS	Cocoa/AppKit (Obj-C++) + Scintilla 5.5.3 static lib	✅ Full IDE
Android	NDK + JNI	🔮 Planned
iOS	UIKit (Objective-C)	🔮 Planned

IDE Progress by Platform

✅ Done   🔧 Partial   — Not started

Area	Feature	Windows	Linux	macOS
Editor	Scintilla integration	✅	✅	✅
	Syntax highlighting (Harbour lexer)	✅	✅	✅
	Code folding (Harbour-aware)	✅	✅	✅
	Auto-complete (150+ keywords)	✅	✅	✅
	Find / Replace bar	✅	✅	✅
	Find Next / Find Previous	✅	✅	✅
	Undo / Redo / Cut / Copy / Paste	✅	✅	✅
	Auto-indent on Enter	✅	✅	✅
	Toggle comment (Ctrl+/)	✅	✅	✅
	Line numbers + status bar	✅	✅	✅
	Tabbed multi-file editing	✅	✅	✅
Designer	Visual form designer (WYSIWYG)	✅	✅	✅
	Drag & drop from palette	✅	✅	✅
	Two-way code sync	✅	✅	✅
	Object Inspector (properties)	✅	✅	✅
	Object Inspector (events)	✅	✅	✅
	Copy/Paste controls (Ctrl+C/V)	✅	✅	✅
	Undo design (50-step)	✅	—	✅
	Tab Order dialog	✅	—	✅
	Format > Align controls (8 modes)	✅	✅	✅
	130 components in 16 tabs	✅	✅	✅
Debugger	Debugger panel (5 tabs)	✅	✅	✅
	Debug toolbar (Run/Step/Stop)	✅	✅	✅
	In-process .hrb execution	✅	✅	✅
	Breakpoint management	✅	✅	✅
	Local variable inspection	✅	✅	✅
	Call stack display	✅	✅	✅
	Unit tests (16 tests)	—	✅	—
Panels	AI Assistant (Ollama chat)	✅	✅	✅
	Project Inspector (TreeView)	✅	✅	✅
	Editor Colors dialog	✅	✅	✅
	Project Options (4 tabs)	✅	✅	✅
Project	New / Open / Save / Save As	✅	✅	✅
	Multi-form projects	✅	✅	✅
	Add / Remove from project	✅	✅	✅
	Build & Run (native compile)	✅	✅	✅
	Multi-compiler (MSVC + BCC)	✅	—	—
	Build progress dialog	✅	—	—
	Build to .app bundle	—	—	✅
Database	TDatabase (abstract base)	✅	✅	✅
	TDBFTable (native DBF/CDX, 20+ methods)	✅	✅	✅
	TSQLite (SQL, transactions, queries)	✅	✅	✅
	TMySQL / TMariaDB	🔧	🔧	🔧
	TPostgreSQL / TFirebird / TSQLServer	🔧	🔧	🔧
	TDataSource (binds DB to controls)	✅	✅	✅
	TDBGrid / TDBNavigator / TDBEdit	✅	✅	✅
	TDBText / TDBComboBox / TDBCheckBox	✅	✅	✅
	4 sample projects (DBF, SQLite, portable, controls)	✅	✅	✅
Reports	Visual Report Designer	✅ GDI	✅ Cairo	✅ CoreGraphics
	Report Preview (pages, zoom, nav)	✅ GDI	✅ Cairo	✅ CoreGraphics
	TReportBand + TReportField data model	✅	✅	✅
	Report code generation (GenerateCode)	✅	✅	✅
	xCommand macros (DEFINE REPORT/BAND)	✅	✅	✅
	Inspector integration (band/field props)	✅	✅	✅
	49 report unit tests	✅	✅	✅
Theme	Dark mode	✅	✅	✅
	Dark code editor	✅	✅	✅
Menus	All menus functional (zero stubs)	✅ 47	✅ 47	✅ 53
Toolbar	All buttons functional	✅ 16	✅ 15	✅ 9
	Two-row toolbar	✅	✅	—

Metrics

Metric	Windows	Linux	macOS
HB_FUNC bridge functions	135	132	158
Backend lines of code	~7100	~7300	~3800
IDE .prg lines of code	~4800	~1200	~1400

---

📁 Project Structure

HarbourBuilder/
├── cpp/                          # Windows C++ core
│   ├── include/hbide.h           # 109 CT_ defines + class declarations
│   └── src/                      # tcontrol, tform, tcontrols, hbbridge
├── backends/
│   ├── cocoa/cocoa_core.m        # macOS Cocoa backend (Obj-C)
│   ├── cocoa/cocoa_editor.mm     # macOS Scintilla editor (Obj-C++)
│   ├── cocoa/cocoa_inspector.m   # macOS Object Inspector
│   ├── gtk3/gtk3_core.c          # Linux GTK3 backend + Scintilla
│   ├── console/backend.prg       # TUI console backend
│   └── web/backend.prg           # HTML5 Canvas backend
├── harbour/
│   ├── classes.prg               # TForm, TControl OOP wrappers
│   ├── hbbuilder.ch              # xBase #xcommand syntax
│   └── inspector.prg             # Object Inspector (Win32)
├── samples/
│   ├── hbbuilder_win.prg         # Windows IDE (full)
│   ├── hbbuilder_macos.prg       # macOS IDE
│   ├── hbbuilder_linux.prg       # Linux IDE
│   └── projects/transformer/     # 7 AI examples
├── docs/
│   ├── assets/css/docs.css       # DeepWiki-style theme
│   ├── assets/js/docs.js         # Search, theme, copy code
│   └── en/                       # 20 HTML pages
├── resources/
│   ├── Scintilla.dll             # Scintilla 5.6.1 (Windows, 32-bit)
│   ├── Lexilla.dll               # Lexilla 5.4.8 (Windows, 32-bit)
│   ├── libscintilla.so           # Scintilla (Linux, x86_64)
│   ├── liblexilla.so             # Lexilla (Linux, x86_64)
│   ├── scintilla_src/            # Scintilla + Lexilla source (macOS build)
│   │   ├── build/libscintilla.a  # Scintilla (macOS, static)
│   │   └── build/liblexilla.a    # Lexilla (macOS, static)
│   ├── lazarus_icons/            # Professional PNG icons
│   └── harbour_logo.png          # About dialog logo
├── tests/
│   ├── test_debugger.prg         # 16 debugger unit tests
│   └── build_test_debugger.sh    # Build & run test suite
├── build_win.bat                 # Windows build script
├── build_scintilla.sh            # Linux Scintilla build script
└── ChangeLog.txt                 # Detailed changelog

---

🤝 Contributing

HarbourBuilder is open source and welcomes contributions:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-control)
3. Implement for all 3 platforms (Win32 + Cocoa + GTK3)
4. Add documentation in docs/en/
5. Submit a Pull Request

Adding a New Control

1. Add CT_MYCONTROL to hbide.h (and both backends)
2. Create class in tcontrols.cpp (constructor + CreateParams)
3. Add HB_FUNC(UI_MyControlNew) in hbbridge.cpp
4. Add widget creation in cocoa_core.m and gtk3_core.c
5. Add to palette in all 3 IDE .prg files
6. Add events in UI_GETALLEVENTS
7. Document in docs/en/

---

⚡ Built with AI

This entire framework — from the C++ core and native backends to the Harbour OOP layer, visual designer, AI assistant, and 20-page documentation — was vibe coded using:

• Claude Code — Anthropic's AI coding assistant
• GLM 5.1 — Zhipu AI's coding model
• Qwen CLI — Alibaba's Qwen coding assistant

A new paradigm in software development.

---

📄 License

MIT License — free for personal and commercial use.

---

⭐ Star this repo if you believe in the future of Harbour development!

Made with ❤️ by Antonio Linares using Claude Code · GLM 5.1 · Qwen CLI