docs: update example readme

Author: deandreamatias

example/README.md

@@ -1,16 +1,73 @@
-# example
+# Flutter Form Builder Example
 
-Example app for flutter_form_builder package
+A comprehensive example application demonstrating the capabilities of the [Flutter Form Builder](https://pub.dev/packages/flutter_form_builder) package.
+
+## Features Demonstrated
+
+This example showcases various form building patterns and use cases:
+
+- **Complete Form** - A full-featured form with all available input types
+- **Sign Up Form** - A practical sign-up form example
+- **Dynamic Fields** - Forms with fields that can be added/removed at runtime
+- **Conditional Fields** - Fields that show/hide based on other field values
+- **Related Fields** - Forms with interdependent field values
+- **Grouped Radio/Checkbox** - Selection inputs with grouping
+- **Decorated Radio/Checkbox** - Custom styling for selection fields
+- **Custom Fields** - Examples of creating custom form fields
 
 ## Getting Started
 
-This project is a starting point for a Flutter application.
+### Installation
+
+1. Navigate to the example directory:
+
+   ```bash
+   cd example
+   ```
+
+2. Get dependencies:
+
+   ```bash
+   flutter pub get
+   ```
+
+3. Run the example:
+
+   ```bash
+   flutter run
+   ```
+
+## Project Structure
+
+```txt
+lib/
+├── main.dart              # App entry point with navigation
+├── code_page.dart         # Shows source code for examples
+├── sources/
+│   ├── complete_form.dart          # All field types demo
+│   ├── signup_form.dart            # Sign up form
+│   ├── dynamic_fields.dart         # Dynamic field management
+│   ├── conditional_fields.dart     # Conditional visibility
+│   ├── related_fields.dart         # Field dependencies
+│   ├── grouped_radio_checkbox.dart # Grouped selections
+│   ├── decorated_radio_checkbox.dart # Styled selections
+│   └── custom_fields.dart          # Custom field implementations
+```
+
+## Learning Resources
+
+Each example demonstrates specific Flutter Form Builder features:
+
+- Form creation and management
+- Field validation
+- Value collection and transformation
+- Dynamic field operations
+- Conditional rendering
 
-A few resources to get you started if this is your first Flutter project:
+Explore each example to understand how to implement similar patterns in your own applications.
 
-- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
-- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
+## Related Resources
 
-For help getting started with Flutter, view our
-[online documentation](https://flutter.dev/docs), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+- [Flutter Form Builder Documentation](https://pub.dev/packages/flutter_form_builder)
+- [Form Builder Validators](https://pub.dev/packages/form_builder_validators)
+- [Flutter Documentation](https://docs.flutter.dev/)