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.
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
Markdown
[](/listings/dotpas--dext)HTML
<a href="/listings/dotpas--dext"><img src="/api/listings/dotpas--dext/badge.svg" alt="findsafeskills safety rating" /></a>Install
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)
- > **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.
- # Dext Framework 1.0
- **Native full-stack for Delphi.**
- <p align="center">
- <img src="Docs/Images/dext-mascot.png" alt="Dext Framework mascot">
- </p>
- The Delphi compiler was never the bottleneck. The missing piece was the infrastructure.
- 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.
- **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.
- > **"Simplicity is Complicated."** — *Rob Pike*
- 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.
- > **"Make what is right easy and what is wrong difficult."** — *Steve "Ardalis" Smith*
- 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.
- And it is **Apache 2.0**: free for the twenty-year ERP and for the product that does not have a name yet.
- ---
- ## Why this matters now
- If the team is glancing at C# because “Delphi has no industry-standard stack,” Dext closes that gap without rewriting the system.
- 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.
- - [**Dext vs .NET: architecture**](Docs/Comparison/Dext_vs_DotNet_Narrative.md) — modern patterns on a native compiler.
- - [**Feature-by-feature matrix**](Docs/Comparison/Feature_Comparison_Dext_vs_DotNet.md) — 60+ items side by side.
- - [**ORM capabilities**](Docs/Comparison/Dext_ORM_Capabilities.md) — DbContext, change tracking, JSON, lazy/eager.
- - [**Enterprise licensing**](Docs/Comparison/Open_Source_Licensing_Enterprise.md) — why Apache 2.0 is safe for commercial use.
- ---
- ## The book
- 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.
- <p align="center">
- <img src="Docs/Images/dext-web-book-mockup.png" alt="Book: Professional Web Development with Delphi and Dext Framework" width="70%">
- </p>
- ### 🇺🇸 English edition
- **Professional Web Development with Delphi and Dext Framework** — Cesar Romero, 1st edition, 2026. ISBN 978-65-02-38868-6.
- - **Paperback (Amazon):** [amazon.com/dp/650238868X](https://www.amazon.com/dp/650238868X)
- - **Kindle:** [amazon.com/dp/B0HKNZR9FW](https://www.amazon.com/dp/B0HKNZR9FW)
- - **Lab source:** [github.com/dotpas/book-dext-web](https://github.com/dotpas/book-dext-web)
- ### 🇧🇷 Portuguese edition
- **Desenvolvimento Web Profissional com Delphi e Dext Framework** — Cesar Romero, 1st edition, 2026. ISBN 978-65-02-32503-2.
- - **Print in Brazil (UICLAP):** [loja.uiclap.com/titulo/ua197387](https://loja.uiclap.com/titulo/ua197387)
- - **Paperback on Amazon:** [amazon.com/dp/6502325033](https://www.amazon.com/dp/6502325033)
- - **Kindle (Brazil):** [amazon.com.br/dp/B0HGYTSYYY](https://www.amazon.com.br/dp/B0HGYTSYYY)
- - **Kindle (global):** [amazon.com/dp/B0HGYTSYYY](https://www.amazon.com/dp/B0HGYTSYYY)
- - **Lab source:** [github.com/dotpas/book-dext-web](https://github.com/dotpas/book-dext-web)
- ---
- ## Where to go after this README
- The README is the taste. The map lives under `Docs`.
- 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).
- 2. **[Complete features index](Docs/Features_Implemented_Index.md)** — everything 1.0 ships, organized by module, with the implementing unit.
- 3. **[.NET comparison pack](Docs/Comparison/README.md)** — for the meeting where someone asks “why not migrate?”
- 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).
- ---
- ## Where Dext fits
- - **High-throughput APIs** — Minimal APIs, Controllers, or `[DataApi]` generating REST from the entity.
- - **Web applications** — SSR with the native template engine or Web Stencils, HTMX without a heavy SPA.
- - **Real concurrency** — `TAsyncTask`, cancellation tokens, async REST client. No hand-rolled `TThread`.
- - **Mobile backends** — the same API for iOS and Android, with JWT, rate limits, and health checks.
- - **Legacy that still has to run** — DataSnap, ISAPI/Apache, VCL. Dext lands as a modern foundation without erasing twenty years of ERP.
- - **Jobs, microservices, IoT** — persistent background jobs, MQTT, gRPC, Redis.
- ---
- ## Five minutes of code
- ### Minimal API
- An endpoint with DI and model binding does not ask for ceremony:
- ```pascal
- program MyAPI;
- uses Dext.Web;
- begin
- var App := WebApplication;
- App.MapGet('/hello', function: string
- begin
- Result := 'Hello from Dext! Modern full-stack for Delphi.';
- end);
- App.MapPost<TUserDto, IEmailService, IResult>('/register',
- function(Dto: TUserDto; EmailService: IEmailService): IResult
- begin
- EmailService.SendWelcome(Dto.Email);
- Result := Results.Created('/login', 'User successfully registered');
- end);
- App.Run(8080);
- end.
- ```
- ### Entity, DataAPI, and Smart Properties
- Convention over Configuration. The class becomes a table — and, if you want, an API:
- ```pascal
- [Table]
- [DataApi('/api/orders')]
- TOrder = class
- private
- FId: IntType;
- FStatus: Prop<TOrderStatus>;
- FNotes: StringType;
- FTotal: Nullable<CurrencyType>;
- FItems: Lazy<IList<TOrderItem>>;
- public
- [PK, AutoInc]
- property Id: IntType read FId write FId;
- property Status: Prop<TOrderStatus> read FStatus write FStatus;
- property Notes: StringType read FNotes write FNotes;
- property Total: Nullable<CurrencyType> read FTotal write FTotal;
- property Items: Lazy<IList<TOrderItem>> read FItems write FItems;
- end.
- ```
- ### Type-safe ORM
- No more magic strings that fail in production. Dext builds the query AST in Pascal:
- ```pascal
- var O := Prototype.Entity<TOrder>;
- var Orders := DbContext.Orders
- .Where((O.Status = TOrderStatus.Paid) and (O.Total > 1000))
- .Include('Customer')
- .Include('Items')
- .OrderBy(O.Date.Desc)
- .Take(50)
- .ToList;
- DbContext.Products
- .Where(Prototype.Entity<TProduct>.Category = 'Outdated')
- .Update
- .Execute;
- ```
- ### Fluent tasks
- `TThread` complexity becomes a pipeline. Thread pool, chaining, a safe return to the UI:
- ```pascal
- var CTS := TCancellationTokenSource.Create;
- TAsyncTask.Run<TStream>(
- function: TStream
- begin
- Result := AsyncClient.DownloadStream('https://api.company.com/data', CTS.Token);
- end)
- .Then<TReport>(
- function(Stream: TStream): TReport
- begin
- Result := JsonSerializer.Deserialize<TReport>(Stream);
- Stream.Free;
- end)
- .OnComplete(
- procedure(Report: TReport)
- begin
- ShowReport(Report);
- end)
- .OnException(
- procedure(Ex: Exception)
- begin
- ShowError('Process failed: ' + Ex.Message);
- end)
- .Start;
- ```
- ### Configuration, Options, and DI
- JSON, YAML, User Secrets, environment variables, command line — Twelve-Factor order:
- ```pascal
- var Builder := WebApplication.CreateBuilder;
- Builder.Configuration
- .AddJsonFile('appsettings.json')
- .AddYamlFile('config.yaml')
- .AddEnvironmentVariables;
- Builder.Services
- .Configure<TDatabaseSettings>(Builder.Configuration.GetSection('Database'))
- .AddSingleton<IEmailService, TSmtpEmailService>
- .AddScoped<IOrderRepository, TDbOrderRepository>;
- var App := Builder.Build;
- ```
- ### VCL without giving up the ORM
- `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.
- ---
- ## Dext is not “just CRUD”
- Everyone ships CRUD. 1.0 was built for what comes next: scale, governance, and the rest of the week.
- ### Database as API
- Full REST from the entity — paging, filters, roles, and Swagger — with one attribute:
- ```pascal
- [Table, DataApi('/api/products')]
- TProduct = class
- private
- FId: IntType;
- [Required, MaxLength(100)]
- FName: StringType;
- FPrice: CurrencyType;
- public
- [PK, AutoInc]
- property Id: IntType read FId write FId;
- property Name: StringType read FName write FName;
- property Price: CurrencyType read FPrice write FPrice;
- end;
- App.MapDataApis.Configure<TProduct>(
- DataApiOptions.RequireAuth.RequireWriteRole(['admin'])
- );
- ```
- ### Native MCP server
- Dext exposes Delphi business rules as tools for agents (Claude, Cursor, Antigravity) over **MCP**, in the same process:
- ```pascal
- type
- [MCPTool('search_products', 'Search active products with price filters')]
- [MCPParam('query', 'Product search query term')]
- [MCPParam('maxPrice', 'Optional maximum price filter')]
- TSearchProductsTool = class
- public
- function Execute(const AQuery: string; AMaxPrice: Currency): TList<TProduct>;
- end;
- ```
- ### Clean Architecture in the IDE
- Decoupling does not have to kill RAD. Context-menu scaffolding, metadata in the Object Inspector, a DBGrid with real rows *before* you press F9.
- <details>
- <summary><b>📸 From the physical database to live data on the form</b></summary>
- <br>
- #### 1. Entity generation from the context menu
- <p align="center">
- <img src="Docs/Images/dext-design-time-step1-menu.webp" alt="Step 1: Dext context menu" width="90%">
- </p>
- #### 2. Table selection
- <p align="center">
- <img src="Docs/Images/dext-design-time-step2-tables.webp" alt="Step 2: Table selection" width="90%">
- </p>
- #### 3. Generated code preview
- <p align="center">
- <img src="Docs/Images/dext-design-time-step3-preview.webp" alt="Step 3: Generated entity code" width="90%">
- </p>
- #### 4. RTTI metadata in the Object Inspector
- <p align="center">
- <img src="Docs/Images/dext-design-time-step4-metadata.webp" alt="Step 4: Entity metadata editor" width="90%">
- </p>
- #### 5. DBGrid with live design-time data
- <p align="center">
- <img src="Docs/Images/dext-design-time-step5-active.webp" alt="Step 5: DBGrid with live data in the IDE" width="90%">
- </p>
- </details>
- ### Stored procedures as commands
- No hand-wired parameters. The procedure becomes a compile-time-checked object:
- ```pascal
- type
- [StoredProcedure('ProcessFiscalNotes')]
- TProcessNotesCommand = class
- private
- FStartDate: TDateTime;
- FProcessedCount: Integer;
- public
- [DbParam('StartDate')]
- property StartDate: TDateTime read FStartDate write FStartDate;
- [DbParam('ProcessedCount', pdOutput)]
- property ProcessedCount: Integer read FProcessedCount write FProcessedCount;
- end;
- ```
- ---
- ## Telemetry that does not ask for Grafana on a laptop
- The built-in dashboard collects structured logs, physical SQL, HTTP latency, and Gantt spans — in the background, without stalling the request.
- <p align="center">
- <img src="Docs/Images/dext-telemetry-live-split.jfif" alt="Real-time telemetry with a running VCL application" width="90%">
- </p>
- <details>
- <summary><b>📸 Dashboard and SQL tracing</b></summary>
- <br>
- #### Metrics, RPS, CPU, and logs
- <p align="center">
- <img src="Docs/Images/dext-telemetry-dashboard.jfif" alt="Dext telemetry dashboard" width="90%">
- </p>
- #### Generated SQL, parameters, and timing
- <p align="center">
- <img src="Docs/Images/dext-telemetry-sql-trace.jfif" alt="Dext ORM SQL tracing" width="90%">
- </p>
- </details>
- When operations grow, **Seq** and **OpenTelemetry** sinks (SigNoz, Datadog) are already in the pipeline.
- ---
- ## The ecosystem, on one page
- <p align="center">
- <img src="Docs/Images/dext_ecosystem.png" alt="Dext ecosystem architecture" width="80%">
- </p>
- You include what the solution needs. The rest stays out.
- - **Core** — DI (Singleton, Transient, Scoped), cached RTTI, `IOptions`, Smart Properties.
- - **Collections** — `IList` / `IDictionary` without the classic leak; Binary Code Folding against generic bloat.
- - **ORM** — Unit of Work, transactions, seven dialects, JSON/JSONB, soft delete, batch.
- - **Web** — Minimal APIs, Controllers, DataAPI, middleware, Hubs/WebSockets, HTTP/2, HTMX, http.sys / epoll.
- - **AI** — native MCP server; skills for Cursor, Claude, and Copilot under `Docs`.
- - **Testing** — `TAutoMocker`, snapshots, WebApplicationFactory, Test Explorer in the IDE.
- **[Full features list and modules](Docs/Features_Implemented_Index.md)** — the 1.0 index, chapter by chapter.
- ---
- ## Installation
- 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:
- ```bash
- 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)**
- ---
- ## Built for performance
- Recent Delphi frameworks chased convenience with unrestricted allocation. Dext gives the pace back without giving the pain back.
- <p align="center">
- <img src="Docs/Images/dext_performance_graph.png" alt="Dext performance graph" width="80%">
- </p>
- 1. **Zero-allocation pipeline** — JSON straight through `TSpan` / UTF-8, without gigabytes of temporary `string` in the memory manager.
- 2. **SIMD** — parse and compare in AVX2/SSE2 blocks, a response in a handful of CPU ticks.
- ---
- ## License
- **Apache License 2.0.** Free for open source and for commercial software. Build, ship, embed. No catch.
- ---
- ## Community
- Dext grows with the people who use it.
- - **Star the repository** — the simplest signal that the project exists.
- - **Real stories** — what you built belongs in [Discussions](https://github.com/dotpas/dext/discussions).
- - **Issues and PRs** — [CONTRIBUTING.md](CONTRIBUTING.md) and the [features workflow](Docs/CONTRIBUTING_IMPROVEMENTS.md).
- Roadmap: [Docs/ROADMAP.md](Docs/ROADMAP.md). Conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md).
- <br>
- <p align="center">
- <i>Stop rebuilding foundations. Spend the energy on the customer's problem. Dext takes care of the rest.</i><br>
- <b>Built with pride for the Delphi ecosystem.</b>
- </p>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.