Skip to content
Back to search

dext

Dext - Modern Full Stack Framework for Delphi

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dotpas/dext with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dotpas/dext'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dotpas--dext/badge.svg)](/listings/dotpas--dext)

HTML

<a href="/listings/dotpas--dext"><img src="/api/listings/dotpas--dext/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The short path is **TMS Smart Setup**. The long path is in the Book.

1. TMS Smart Setup (recommended)

Dext is a community package. Enable the Community Server once:

tms server-enable community
tms install dotpas.dext

In the GUI: open TMS Smart Setup, enable **Community Server** in settings, search for `dotpas.dext`, and click **Install**.

> [!TIP] > No Smart Setup yet? [Download page](https://doc.tmssoftware.com/smartsetup/download/).

2. Manual installation

Paths, `Dext.inc`, design-time packages:

- **[Full setup and installation guide](Docs/Book/01-getting-started/installation.md)**

Requirements

- **Tier 1:** Delphi 10.4 Sydney, 11 Alexandria, 12 Athens. - **Tier 2:** 10.1 Berlin – 10.3 Rio, with limitations (no inline vars). - **Compile floor:** XE2+, with Indy fallback below XE8. - **Dependencies:** none required. HTTP uses Indy (already in Delphi) — subject to evolution. - **Web Stencils:** Delphi 12.2+ (Windows).

**[Compatibility matrix](Docs/Delphi_Compatibility_Matrix.md)**

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 440 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. > **Lê em português?** Este README está em inglês. A versão completa em português — com os mesmos exemplos, o livro e o mapa de features — está em [README.pt-br.md](README.pt-br.md). Se o português for mais confortável, clique e leia o documento inteiro por lá, em vez de passar o olho num atalho.
  2. # Dext Framework 1.0
  3. **Native full-stack for Delphi.**
  4. <p align="center">
  5. <img src="Docs/Images/dext-mascot.png" alt="Dext Framework mascot">
  6. </p>
  7. The Delphi compiler was never the bottleneck. The missing piece was the infrastructure.
  8. For years, a modern Object Pascal backend meant stitching a dozen libraries: one for DI, one for HTTP, one for ORM, one for tests. Each with its own dialect. None of them slept in the same house.
  9. **Dext 1.0** is that infrastructure. One ecosystem — dependency injection, ORM, web pipeline, telemetry, and testing — compiled native. No JIT. No cold start. No patchwork.
  10. > **"Simplicity is Complicated."** — *Rob Pike*
  11. A Minimal API fits on one screen because the engine underneath does not. UTF-8 JSON, DI, binding, validation, Direct-to-JSON: the ceremony lives in the framework.
  12. > **"Make what is right easy and what is wrong difficult."** — *Steve "Ardalis" Smith*
  13. Reading a catalog is an entity. Changing the world is a command with a rule. The test is born in the constructor. With Dext, the right path is the short one.
  14. And it is **Apache 2.0**: free for the twenty-year ERP and for the product that does not have a name yet.
  15. ---
  16. ## Why this matters now
  17. If the team is glancing at C# because “Delphi has no industry-standard stack,” Dext closes that gap without rewriting the system.
  18. Functional parity with ASP.NET Core and Entity Framework Core, in the language you already ship, plus what the managed runtime does not give away: a native binary, a small memory footprint, instant startup.
  19. - [**Dext vs .NET: architecture**](Docs/Comparison/Dext_vs_DotNet_Narrative.md) — modern patterns on a native compiler.
  20. - [**Feature-by-feature matrix**](Docs/Comparison/Feature_Comparison_Dext_vs_DotNet.md) — 60+ items side by side.
  21. - [**ORM capabilities**](Docs/Comparison/Dext_ORM_Capabilities.md) — DbContext, change tracking, JSON, lazy/eager.
  22. - [**Enterprise licensing**](Docs/Comparison/Open_Source_Licensing_Enterprise.md) — why Apache 2.0 is safe for commercial use.
  23. ---
  24. ## The book
  25. This is not a feature catalog. It is a real corporate product — **Dext Faturamento** — built from scratch across five labs: Minimal APIs, persistence, multi-tenant SaaS, JWT, jobs, Redis, Hubs, Docker, gRPC, and tools for AI agents. The model stays yours. The agent does not get to invent SQL.
  26. <p align="center">
  27. <img src="Docs/Images/dext-web-book-mockup.png" alt="Book: Professional Web Development with Delphi and Dext Framework" width="70%">
  28. </p>
  29. ### 🇺🇸 English edition
  30. **Professional Web Development with Delphi and Dext Framework** — Cesar Romero, 1st edition, 2026. ISBN 978-65-02-38868-6.
  31. - **Paperback (Amazon):** [amazon.com/dp/650238868X](https://www.amazon.com/dp/650238868X)
  32. - **Kindle:** [amazon.com/dp/B0HKNZR9FW](https://www.amazon.com/dp/B0HKNZR9FW)
  33. - **Lab source:** [github.com/dotpas/book-dext-web](https://github.com/dotpas/book-dext-web)
  34. ### 🇧🇷 Portuguese edition
  35. **Desenvolvimento Web Profissional com Delphi e Dext Framework** — Cesar Romero, 1st edition, 2026. ISBN 978-65-02-32503-2.
  36. - **Print in Brazil (UICLAP):** [loja.uiclap.com/titulo/ua197387](https://loja.uiclap.com/titulo/ua197387)
  37. - **Paperback on Amazon:** [amazon.com/dp/6502325033](https://www.amazon.com/dp/6502325033)
  38. - **Kindle (Brazil):** [amazon.com.br/dp/B0HGYTSYYY](https://www.amazon.com.br/dp/B0HGYTSYYY)
  39. - **Kindle (global):** [amazon.com/dp/B0HGYTSYYY](https://www.amazon.com/dp/B0HGYTSYYY)
  40. - **Lab source:** [github.com/dotpas/book-dext-web](https://github.com/dotpas/book-dext-web)
  41. ---
  42. ## Where to go after this README
  43. The README is the taste. The map lives under `Docs`.
  44. 1. **[The Dext Book](Docs/Book/README.md)** — the official guide: install, Minimal APIs, ORM, security, real-time, CLI, MCP. Start with [Where to start](Docs/Book/01-getting-started/where-to-start.md) and [Installation](Docs/Book/01-getting-started/installation.md).
  45. 2. **[Complete features index](Docs/Features_Implemented_Index.md)** — everything 1.0 ships, organized by module, with the implementing unit.
  46. 3. **[.NET comparison pack](Docs/Comparison/README.md)** — for the meeting where someone asks “why not migrate?”
  47. The Portuguese editions of the same docs live under [`Docs/Book.pt-br`](Docs/Book.pt-br/README.md) and [`Docs/Features_Implemented_Index.pt-br.md`](Docs/Features_Implemented_Index.pt-br.md).
  48. ---
  49. ## Where Dext fits
  50. - **High-throughput APIs** — Minimal APIs, Controllers, or `[DataApi]` generating REST from the entity.
  51. - **Web applications** — SSR with the native template engine or Web Stencils, HTMX without a heavy SPA.
  52. - **Real concurrency** — `TAsyncTask`, cancellation tokens, async REST client. No hand-rolled `TThread`.
  53. - **Mobile backends** — the same API for iOS and Android, with JWT, rate limits, and health checks.
  54. - **Legacy that still has to run** — DataSnap, ISAPI/Apache, VCL. Dext lands as a modern foundation without erasing twenty years of ERP.
  55. - **Jobs, microservices, IoT** — persistent background jobs, MQTT, gRPC, Redis.
  56. ---
  57. ## Five minutes of code
  58. ### Minimal API
  59. An endpoint with DI and model binding does not ask for ceremony:
  60. ```pascal
  61. program MyAPI;
  62. uses Dext.Web;
  63. begin
  64. var App := WebApplication;
  65. App.MapGet('/hello', function: string
  66. begin
  67. Result := 'Hello from Dext! Modern full-stack for Delphi.';
  68. end);
  69. App.MapPost<TUserDto, IEmailService, IResult>('/register',
  70. function(Dto: TUserDto; EmailService: IEmailService): IResult
  71. begin
  72. EmailService.SendWelcome(Dto.Email);
  73. Result := Results.Created('/login', 'User successfully registered');
  74. end);
  75. App.Run(8080);
  76. end.
  77. ```
  78. ### Entity, DataAPI, and Smart Properties
  79. Convention over Configuration. The class becomes a table — and, if you want, an API:
  80. ```pascal
  81. [Table]
  82. [DataApi('/api/orders')]
  83. TOrder = class
  84. private
  85. FId: IntType;
  86. FStatus: Prop<TOrderStatus>;
  87. FNotes: StringType;
  88. FTotal: Nullable<CurrencyType>;
  89. FItems: Lazy<IList<TOrderItem>>;
  90. public
  91. [PK, AutoInc]
  92. property Id: IntType read FId write FId;
  93. property Status: Prop<TOrderStatus> read FStatus write FStatus;
  94. property Notes: StringType read FNotes write FNotes;
  95. property Total: Nullable<CurrencyType> read FTotal write FTotal;
  96. property Items: Lazy<IList<TOrderItem>> read FItems write FItems;
  97. end.
  98. ```
  99. ### Type-safe ORM
  100. No more magic strings that fail in production. Dext builds the query AST in Pascal:
  101. ```pascal
  102. var O := Prototype.Entity<TOrder>;
  103. var Orders := DbContext.Orders
  104. .Where((O.Status = TOrderStatus.Paid) and (O.Total > 1000))
  105. .Include('Customer')
  106. .Include('Items')
  107. .OrderBy(O.Date.Desc)
  108. .Take(50)
  109. .ToList;
  110. DbContext.Products
  111. .Where(Prototype.Entity<TProduct>.Category = 'Outdated')
  112. .Update
  113. .Execute;
  114. ```
  115. ### Fluent tasks
  116. `TThread` complexity becomes a pipeline. Thread pool, chaining, a safe return to the UI:
  117. ```pascal
  118. var CTS := TCancellationTokenSource.Create;
  119. TAsyncTask.Run<TStream>(
  120. function: TStream
  121. begin
  122. Result := AsyncClient.DownloadStream('https://api.company.com/data', CTS.Token);
  123. end)
  124. .Then<TReport>(
  125. function(Stream: TStream): TReport
  126. begin
  127. Result := JsonSerializer.Deserialize<TReport>(Stream);
  128. Stream.Free;
  129. end)
  130. .OnComplete(
  131. procedure(Report: TReport)
  132. begin
  133. ShowReport(Report);
  134. end)
  135. .OnException(
  136. procedure(Ex: Exception)
  137. begin
  138. ShowError('Process failed: ' + Ex.Message);
  139. end)
  140. .Start;
  141. ```
  142. ### Configuration, Options, and DI
  143. JSON, YAML, User Secrets, environment variables, command line — Twelve-Factor order:
  144. ```pascal
  145. var Builder := WebApplication.CreateBuilder;
  146. Builder.Configuration
  147. .AddJsonFile('appsettings.json')
  148. .AddYamlFile('config.yaml')
  149. .AddEnvironmentVariables;
  150. Builder.Services
  151. .Configure<TDatabaseSettings>(Builder.Configuration.GetSection('Database'))
  152. .AddSingleton<IEmailService, TSmtpEmailService>
  153. .AddScoped<IOrderRepository, TDbOrderRepository>;
  154. var App := Builder.Build;
  155. ```
  156. ### VCL without giving up the ORM
  157. `TEntityDataSet` puts POCOs on the DBGrid, FastReport, and the Object Inspector. Real design-time: *TFields* and live data in the IDE, without compiling the project.
  158. ---
  159. ## Dext is not “just CRUD”
  160. Everyone ships CRUD. 1.0 was built for what comes next: scale, governance, and the rest of the week.
  161. ### Database as API
  162. Full REST from the entity — paging, filters, roles, and Swagger — with one attribute:
  163. ```pascal
  164. [Table, DataApi('/api/products')]
  165. TProduct = class
  166. private
  167. FId: IntType;
  168. [Required, MaxLength(100)]
  169. FName: StringType;
  170. FPrice: CurrencyType;
  171. public
  172. [PK, AutoInc]
  173. property Id: IntType read FId write FId;
  174. property Name: StringType read FName write FName;
  175. property Price: CurrencyType read FPrice write FPrice;
  176. end;
  177. App.MapDataApis.Configure<TProduct>(
  178. DataApiOptions.RequireAuth.RequireWriteRole(['admin'])
  179. );
  180. ```
  181. ### Native MCP server
  182. Dext exposes Delphi business rules as tools for agents (Claude, Cursor, Antigravity) over **MCP**, in the same process:
  183. ```pascal
  184. type
  185. [MCPTool('search_products', 'Search active products with price filters')]
  186. [MCPParam('query', 'Product search query term')]
  187. [MCPParam('maxPrice', 'Optional maximum price filter')]
  188. TSearchProductsTool = class
  189. public
  190. function Execute(const AQuery: string; AMaxPrice: Currency): TList<TProduct>;
  191. end;
  192. ```
  193. ### Clean Architecture in the IDE
  194. Decoupling does not have to kill RAD. Context-menu scaffolding, metadata in the Object Inspector, a DBGrid with real rows *before* you press F9.
  195. <details>
  196. <summary><b>📸 From the physical database to live data on the form</b></summary>
  197. <br>
  198. #### 1. Entity generation from the context menu
  199. <p align="center">
  200. <img src="Docs/Images/dext-design-time-step1-menu.webp" alt="Step 1: Dext context menu" width="90%">
  201. </p>
  202. #### 2. Table selection
  203. <p align="center">
  204. <img src="Docs/Images/dext-design-time-step2-tables.webp" alt="Step 2: Table selection" width="90%">
  205. </p>
  206. #### 3. Generated code preview
  207. <p align="center">
  208. <img src="Docs/Images/dext-design-time-step3-preview.webp" alt="Step 3: Generated entity code" width="90%">
  209. </p>
  210. #### 4. RTTI metadata in the Object Inspector
  211. <p align="center">
  212. <img src="Docs/Images/dext-design-time-step4-metadata.webp" alt="Step 4: Entity metadata editor" width="90%">
  213. </p>
  214. #### 5. DBGrid with live design-time data
  215. <p align="center">
  216. <img src="Docs/Images/dext-design-time-step5-active.webp" alt="Step 5: DBGrid with live data in the IDE" width="90%">
  217. </p>
  218. </details>
  219. ### Stored procedures as commands
  220. No hand-wired parameters. The procedure becomes a compile-time-checked object:
  221. ```pascal
  222. type
  223. [StoredProcedure('ProcessFiscalNotes')]
  224. TProcessNotesCommand = class
  225. private
  226. FStartDate: TDateTime;
  227. FProcessedCount: Integer;
  228. public
  229. [DbParam('StartDate')]
  230. property StartDate: TDateTime read FStartDate write FStartDate;
  231. [DbParam('ProcessedCount', pdOutput)]
  232. property ProcessedCount: Integer read FProcessedCount write FProcessedCount;
  233. end;
  234. ```
  235. ---
  236. ## Telemetry that does not ask for Grafana on a laptop
  237. The built-in dashboard collects structured logs, physical SQL, HTTP latency, and Gantt spans — in the background, without stalling the request.
  238. <p align="center">
  239. <img src="Docs/Images/dext-telemetry-live-split.jfif" alt="Real-time telemetry with a running VCL application" width="90%">
  240. </p>
  241. <details>
  242. <summary><b>📸 Dashboard and SQL tracing</b></summary>
  243. <br>
  244. #### Metrics, RPS, CPU, and logs
  245. <p align="center">
  246. <img src="Docs/Images/dext-telemetry-dashboard.jfif" alt="Dext telemetry dashboard" width="90%">
  247. </p>
  248. #### Generated SQL, parameters, and timing
  249. <p align="center">
  250. <img src="Docs/Images/dext-telemetry-sql-trace.jfif" alt="Dext ORM SQL tracing" width="90%">
  251. </p>
  252. </details>
  253. When operations grow, **Seq** and **OpenTelemetry** sinks (SigNoz, Datadog) are already in the pipeline.
  254. ---
  255. ## The ecosystem, on one page
  256. <p align="center">
  257. <img src="Docs/Images/dext_ecosystem.png" alt="Dext ecosystem architecture" width="80%">
  258. </p>
  259. You include what the solution needs. The rest stays out.
  260. - **Core** — DI (Singleton, Transient, Scoped), cached RTTI, `IOptions`, Smart Properties.
  261. - **Collections** — `IList` / `IDictionary` without the classic leak; Binary Code Folding against generic bloat.
  262. - **ORM** — Unit of Work, transactions, seven dialects, JSON/JSONB, soft delete, batch.
  263. - **Web** — Minimal APIs, Controllers, DataAPI, middleware, Hubs/WebSockets, HTTP/2, HTMX, http.sys / epoll.
  264. - **AI** — native MCP server; skills for Cursor, Claude, and Copilot under `Docs`.
  265. - **Testing** — `TAutoMocker`, snapshots, WebApplicationFactory, Test Explorer in the IDE.
  266. **[Full features list and modules](Docs/Features_Implemented_Index.md)** — the 1.0 index, chapter by chapter.
  267. ---
  268. ## Installation
  269. The short path is **TMS Smart Setup**. The long path is in the Book.
  270. ### 1. TMS Smart Setup (recommended)
  271. Dext is a community package. Enable the Community Server once:
  272. ```bash
  273. tms server-enable community
  274. tms install dotpas.dext
  275. ```
  276. In the GUI: open TMS Smart Setup, enable **Community Server** in settings, search for `dotpas.dext`, and click **Install**.
  277. > [!TIP]
  278. > No Smart Setup yet? [Download page](https://doc.tmssoftware.com/smartsetup/download/).
  279. ### 2. Manual installation
  280. Paths, `Dext.inc`, design-time packages:
  281. - **[Full setup and installation guide](Docs/Book/01-getting-started/installation.md)**
  282. ### Requirements
  283. - **Tier 1:** Delphi 10.4 Sydney, 11 Alexandria, 12 Athens.
  284. - **Tier 2:** 10.1 Berlin – 10.3 Rio, with limitations (no inline vars).
  285. - **Compile floor:** XE2+, with Indy fallback below XE8.
  286. - **Dependencies:** none required. HTTP uses Indy (already in Delphi) — subject to evolution.
  287. - **Web Stencils:** Delphi 12.2+ (Windows).
  288. **[Compatibility matrix](Docs/Delphi_Compatibility_Matrix.md)**
  289. ---
  290. ## Built for performance
  291. Recent Delphi frameworks chased convenience with unrestricted allocation. Dext gives the pace back without giving the pain back.
  292. <p align="center">
  293. <img src="Docs/Images/dext_performance_graph.png" alt="Dext performance graph" width="80%">
  294. </p>
  295. 1. **Zero-allocation pipeline** — JSON straight through `TSpan` / UTF-8, without gigabytes of temporary `string` in the memory manager.
  296. 2. **SIMD** — parse and compare in AVX2/SSE2 blocks, a response in a handful of CPU ticks.
  297. ---
  298. ## License
  299. **Apache License 2.0.** Free for open source and for commercial software. Build, ship, embed. No catch.
  300. ---
  301. ## Community
  302. Dext grows with the people who use it.
  303. - **Star the repository** — the simplest signal that the project exists.
  304. - **Real stories** — what you built belongs in [Discussions](https://github.com/dotpas/dext/discussions).
  305. - **Issues and PRs** — [CONTRIBUTING.md](CONTRIBUTING.md) and the [features workflow](Docs/CONTRIBUTING_IMPROVEMENTS.md).
  306. Roadmap: [Docs/ROADMAP.md](Docs/ROADMAP.md). Conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md).
  307. <br>
  308. <p align="center">
  309. <i>Stop rebuilding foundations. Spend the energy on the customer's problem. Dext takes care of the rest.</i><br>
  310. <b>Built with pride for the Delphi ecosystem.</b>
  311. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.