Skip to main content

Installation

Before you start​

Use an existing Flutter application or create a clean one:

flutter create fdc_quickstart
cd fdc_quickstart

The Community package requires Dart 3.11.5 or newer. Run flutter --version to confirm the Dart version bundled with your Flutter SDK. See Platform Support for the supported application targets.

Add the package​

Add the Community package to your Flutter project:

flutter pub add flutter_data_components

Import the public API from the package entry point:

import 'package:flutter_data_components/fdc.dart';

The command updates pubspec.yaml and resolves the package. If dependencies were added manually, run flutter pub get before building.

Expected result​

FD Components is built around a dataset-first workflow. A typical screen creates or receives an FdcDataSet, opens or loads its data, and binds the same dataset to a grid or data-aware editors.

After installation, the import above should resolve without analyzer errors. The next step replaces lib/main.dart with a small typed dataset and an editable grid so the complete lifecycle is visible before adapters are introduced.

Troubleshooting​

  • Package resolution reports an SDK mismatch: update Flutter to a release that includes Dart 3.11.5 or newer, then retry flutter pub get.
  • The package import is unresolved: confirm the dependency appears under dependencies in pubspec.yaml and run flutter pub get from the project root.
  • The app builds but the grid has no usable height: place the grid in a bounded parent such as Expanded, SizedBox, or the Scaffold.body layout used in the Quickstart.

Next: Quickstart

For edition status and Pro preview guidance, see Editions and Availability.