Skip to main content

FD Components

FD Components is a high-performance RAD component suite for Flutter, centered on adapters, typed DataSets, data-aware editors, and an editable data grid.

It is designed for the screens that dominate real business software: orders, invoices, inventory, administration, POS systems, ERP modules, back-office tools, and other structured data workflows.

Instead of rebuilding schema rules, validation, edit state, formatting, navigation, filtering, sorting, and persistence glue for every screen, FD Components centers the application around a typed data model that grids, editors, and adapters share.

The model​

The core relationship is intentionally simple:

Adapter → DataSet → Grid and Editors

  • Adapters load, query, page, aggregate, and persist data against memory, databases, or services.
  • FdcDataSet owns schema, records, navigation, edit state, validation, filtering, sorting, search, change tracking, and adapter interaction.
  • Field definitions describe types, labels, validation, defaults, keys, formatting constraints, and storage behavior.
  • FdcGrid and data-aware editors bind directly to the DataSet.

That shared model lets one field definition drive behavior across editing, validation, formatting, filtering, display, and persistence.

Where to start​

New to FD Components? Start with the Quickstart and then build a complete first screen with First DataSet, First Grid, and Editing Data.

For focused exploration, these are the main areas of the documentation:

Grid​

Start with the Grid overview, then explore column types, editing, filtering, selection, pagination, summary rows, context menus, and theming.

Community applications use FdcGrid. Pro users should use FdcProGrid for grids that need Pro functionality such as detail rows, range selection, or layout persistence; it retains the Community grid surface and adds the Pro configuration points.

Editors​

See the Editors overview for data-aware text, numeric, date/time, boolean, combo, and lookup editors. Editor values, validation, focus behavior, and dataset synchronization all follow the same DataSet field model.

DataSet and fields​

The DataSet concepts section explains the central runtime model. Continue with fields, editing lifecycle, change tracking, record iteration, validation, and paging.

For exact decimal arithmetic and fixed-scale business values, see FdcDecimal.

Data adapters​

Use the Data Adapters overview to choose a backend strategy. The documentation covers the in-memory adapter, SQLite, JSON/REST integration, server-side operations, and custom adapter implementations.

Export​

The Export overview explains DataSet and grid export, export scopes, raw versus display values, custom formats, and the Pro Excel and PDF writers.

Application-wide configuration​

Use FdcApp to define shared defaults for localization and translations, format settings, focus management, themes, and export styling.

The Library Entrypoints reference explains when to use fdc.dart and the smaller focused barrels such as fdc_app.dart, fdc_edit.dart, and fdc_export.dart.

Editions​

Documentation is organized by task and concept, not by edition. Community capabilities are available in the public flutter_data_components package. Pro capabilities extend the same programming model with advanced adapters and productivity features.

Pro-only topics appear in their natural place in the documentation and are marked with a small PRO badge in the sidebar. Pages that cover both editions are not labeled as Pro-only.

Build your first screen​

A good first pass through the documentation is:

Installation → Quickstart → First DataSet → First Grid → Editing Data → Saving Changes