Project Management
KIDEx works with Kittox application projects. A project is simply a Home directory containing the Metadata folder (with Models, Views, Layouts and Config files) and optionally Resources, ReportTemplates, and other runtime assets.
Creating a new project
Use File > New Project to launch the project creation wizard.
The wizard provides two project templates:
| Template | Description |
|---|---|
| Empty | Minimal project with Config.yaml, empty Models/ and Views/ folders, and a basic .dpr with UseKitto.pas. |
| Basic | Pre-configured project with a sample database connection, authentication setup, a Home view with a tree menu, and a sample model/view pair. |
After completing the wizard, KIDEx generates:
Home/Metadata/Config.yaml— main configuration fileHome/Metadata/Models/— model definitions folderHome/Metadata/Views/— view definitions folderHome/Metadata/Views/Layouts/— layout definitions folderSource/Controllers.pas— custom controller unitSource/Rules.pas— custom business rules unitSource/UseKitto.pas— unit that references all required Kittox unitsProjects/D13/MyApp.dpr— Delphi project file
Opening an existing project
Use File > Open Project and select the Home directory of an existing Kittox application. KIDEx scans the Metadata folder and builds the project tree.
You can also pass the project path as a command-line parameter:
KIDEX.exe "D:\MyProjects\MyApp\Home"Project tree
The left panel displays the project structure as a navigable tree:
| Node | Contents |
|---|---|
| Models | Data model definitions (one .yaml file per model). Each model maps to a database table. |
| Views | UI definitions: Data views, Tree views (menus), and other controller views. |
| Layouts | Form and grid layout definitions that control field arrangement in forms. |
| Config | The Config.yaml file (and any alternate configs like ConfigDesktop.yaml). |
| Resources | Static files: CSS, images, JavaScript, templates. |
Double-click any item to open it in the editor panel. The tree supports:
- Drag & drop to reorder nodes
- Delete to remove a node (with confirmation)
- Right-click to access the context menu with available properties and child nodes
Integrated HTTP server
KIDEx includes a built-in HTTP server identical to the one in Kitto.Vcl.MainForm. You can start and stop it directly from the toolbar.
- Click Start (green play button) to launch the server
- The Home URL appears as a clickable link in the log panel
- Click Stop (red stop button) to shut down the server
- The Sessions tab shows active sessions with user agent, IP address, and last request time
This allows you to edit YAML metadata, restart the server, and immediately see the changes in the browser — all without leaving KIDEx.
Config file selection
If the Metadata folder contains multiple config files (e.g. Config.yaml, ConfigDesktop.yaml, Config_MyApp.yaml), KIDEx shows a dropdown in the toolbar to select which one to use when starting the server.
