Skip to content

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:

TemplateDescription
EmptyMinimal project with Config.yaml, empty Models/ and Views/ folders, and a basic .dpr with UseKitto.pas.
BasicPre-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 file
  • Home/Metadata/Models/ — model definitions folder
  • Home/Metadata/Views/ — view definitions folder
  • Home/Metadata/Views/Layouts/ — layout definitions folder
  • Source/Controllers.pas — custom controller unit
  • Source/Rules.pas — custom business rules unit
  • Source/UseKitto.pas — unit that references all required Kittox units
  • Projects/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:

NodeContents
ModelsData model definitions (one .yaml file per model). Each model maps to a database table.
ViewsUI definitions: Data views, Tree views (menus), and other controller views.
LayoutsForm and grid layout definitions that control field arrangement in forms.
ConfigThe Config.yaml file (and any alternate configs like ConfigDesktop.yaml).
ResourcesStatic 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.

Released under Apache License, Version 2.0.