Merge pull request #31 from Iconica-Development/feature/default_style

feat: default styling

.github/dependabot.yaml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "pub"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/component-documentation.yml

@@ -0,0 +1,14 @@
+name: Iconica Standard Component Documentation Workflow
+# Workflow Caller version: 1.0.0
+
+on:
+  release:
+    types: [published]
+
+  workflow_dispatch:
+
+jobs:
+  call-iconica-component-documentation-workflow:
+    uses: Iconica-Development/.github/.github/workflows/component-documentation.yml@master
+    secrets: inherit
+    permissions: write-all

.github/workflows/flutter.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches:
+      - master
+      - feature/*
+      - bugfix/*
+      - hotfix/*
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/cache@v3
+        with:
+          path: |
+            ~/.gradle/wrapper
+            /opt/hostedtoolcache/flutter
+          key: ${{ runner.OS }}-flutter-install-cache
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: 'stable'
+      - name: Flutter pub get
+        run: flutter pub get
+      - name: Dart format
+        run: dart format -o none --set-exit-if-changed .
+      - name: Flutter analyze
+        run: flutter analyze

.gitignore

@@ -34,3 +34,8 @@ migrate_working_dir/
 build/
 .flutter-plugins
 .flutter-plugins-dependencies
+.metadata
+
+# FVM Version Cache
+.fvm/
+.fvmrc

CHANGELOG.md

@@ -3,6 +3,65 @@ SPDX-FileCopyrightText: 2022 Iconica
 
 SPDX-License-Identifier: GPL-3.0-or-later
 -->
+# 3.0.0
+- fix: fixed the issue with the scrollController when the `pageToReturnTo` is null.
+- feat: Added default styling and theme.
+- feat: Added Iconica linter.
+# 2.0.4
+- feat: added maxFormWidth to AuthScreen
+
+# 2.0.3
+- feat: added default registrationOptions
+
+# 2.0.2
+- fix: fixed the issue with values not being saved when calling nextStep.
+
+# 2.0.1
+- feat: added circular progress indicator while awaiting registration of user
+- feat: added alignment option for buttons
+
+# 2.0.0
+- feat(buttons): Added the possiblity to only have a next button by return zero on the previous button builder
+- feat: exposed input decoration in AuthTextField
+- feat: added title widget and login button builder
+- feat(bool): Add a boolean field. Can be used for accepting terms and conditions
+- feat(pass): Add dedicated password screen that manages state internally 
+- fix: Small refactor and brought back the normal alignment for the screens
+- fix: Fixed alignment and spacing when opening keyboard
+- feat: add auth drop down field
+- fix: added step to button builders
+- fix: exported auth_pass_field
+- feat: added validation to disable next button
+- feat(auth-screen): add flexible spacing between fields
+- fix(keyboard-focus): add unfocus for onPrevious
+- fix: add empty and required constructors for the RegistrationTranslations
+
+# 1.2.0
+
+- feat: Added the ability to have an async register function so you can call it asynchronous. 
+
+# 1.1.0
+
+- feat: Added the ability to go to specific page on error
+
+# 1.0.0
+
+- feat: Added an onError function.
+- feat: Register function in RegistrationRepository can now return a nullable string. Works like a validator.
+
+# 0.5.0
+
+- feat: add customBackgroundColor to AuthScreen
+- fix: fix linter
+- fix: fix translations to English
+
+# 0.4.0 
+
+- feat: Added the abilty to show and hide the passwords
+
+## 0.3.0
+
+- Added the abilty to set an initial value fot the default email field
 
 ## 0.2.0
 

README.md

@@ -1,13 +1,17 @@
 [![pub package](https://img.shields.io/pub/v/bottom_alert_dialog.svg)](https://github.com/Iconica-Development) [![Build status](https://github.com/Iconica-Development/flutter_registration)](https://github.com/Iconica-Development/flutter_registration/actions/new) [![style: effective dart](https://img.shields.io/badge/style-effective_dart-40c4ff.svg)](https://github.com/tenhobi/effective_dart) 
 
+# Flutter Registration
 
-Registration plug-in.
+Flutter Registration is a package to easily implement
+a registration flow in your app.
 
-## Install
+![Registration GIF](flutter_registration.gif)
 
-To use this package, add `flutter_registration` as a [dependency in your pubspec.yaml file](https://flutter.dev/docs/development/platform-integration/platform-channels).
+## Setup
 
-## Configure
+To use this package, add `flutter_registration` as a dependency in your pubspec.yaml file.
+
+## How to use
 
 To configure the registration plug-in use the ```RegistrationScreen``` widget.
 
@@ -44,6 +48,8 @@ class ExampleRegistrationRepository with RegistrationRepository {
 }
 ```
 
+See the [Example Code](example/lib/main.dart) for an example on how to use this package.
+
 ## Issues
 
 Please file any issues, bugs or feature request as an issue on our [GitHub](https://github.com/Iconica-Development/flutter_registration) page. Commercial support is available if you need help with integration with your app or services. You can contact us at [support@iconica.nl](mailto:support@iconica.nl).
@@ -54,4 +60,4 @@ If you would like to contribute to the plugin (e.g. by improving the documentati
 
 ## Author
 
-This flutter_registration for Flutter is developed by [Iconica](https://iconica.nl). You can contact us at <support@iconica.nl>
+This `flutter_registration` for Flutter is developed by [Iconica](https://iconica.nl). You can contact us at <support@iconica.nl>

analysis_options.yaml

@@ -1,218 +1,9 @@
-# SPDX-FileCopyrightText: 2022 Iconica
+include: package:flutter_iconica_analysis/components_options.yaml
-#
+
-# SPDX-License-Identifier: GPL-3.0-or-later
+# Possible to overwrite the rules from the package
 
-include: package:flutter_lints/flutter.yaml
 analyzer:
-  errors:
+  exclude:
-    todo: ignore
-  exclude: [lib/generated_plugin_registrant.dart]
-linter:
-  # https://dart.dev/tools/linter-rules#lints
-  rules:
-    # error rules
-    always_use_package_imports: false
-    avoid_dynamic_calls: true
-    avoid_empty_else: true
-    avoid_print: true
-    avoid_relative_lib_imports: true
-    avoid_returning_null_for_future: true
-    avoid_slow_async_io: true
-    avoid_type_to_string: true
-    avoid_types_as_parameter_names: true
-    avoid_web_libraries_in_flutter: true
-    cancel_subscriptions: true
-    close_sinks: true
-    comment_references: false
-    control_flow_in_finally: true
-    diagnostic_describe_all_properties: false
-    empty_statements: true
-    hash_and_equals: true
-    invariant_booleans: true
-    iterable_contains_unrelated_type: true
-    list_remove_unrelated_type: true
-    literal_only_boolean_expressions: true
-    no_adjacent_strings_in_list: true
-    no_duplicate_case_values: true
-    no_logic_in_create_state: true
-    prefer_relative_imports: false
-    prefer_void_to_null: true
-    test_types_in_equals: true
-    throw_in_finally: true
-    unnecessary_statements: true
-    unrelated_type_equality_checks: true
-    unsafe_html: true
-    use_build_context_synchronously: true
-    use_key_in_widget_constructors: true
-    valid_regexps: true
-    # style rules
-    always_declare_return_types: true
-    always_put_control_body_on_new_line: true
-    always_put_required_named_parameters_first: true
-    always_require_non_null_named_parameters: true
-    always_specify_types: false
-    annotate_overrides: true
-    avoid_annotating_with_dynamic: false
-    avoid_bool_literals_in_conditional_expressions: true
-    avoid_catches_without_on_clauses: false
-    avoid_catching_errors: false
-    avoid_classes_with_only_static_members: true
-    avoid_double_and_int_checks: true
-    avoid_equals_and_hash_code_on_mutable_classes: false
-    avoid_escaping_inner_quotes: false
-    avoid_field_initializers_in_const_classes: true
-    avoid_final_parameters: true
-    avoid_function_literals_in_foreach_calls: true
-    avoid_implementing_value_types: true
-    avoid_init_to_null: true
-    avoid_js_rounded_ints: true
-    avoid_multiple_declarations_per_line: true
-    avoid_null_checks_in_equality_operators: true
-    avoid_positional_boolean_parameters: true
-    avoid_private_typedef_functions: true
-    avoid_redundant_argument_values: false
-    avoid_renaming_method_parameters: true
-    avoid_return_types_on_setters: true
-    avoid_returning_null: true
-    avoid_returning_null_for_void: true
-    avoid_returning_this: true
-    avoid_setters_without_getters: true
-    avoid_shadowing_type_parameters: true
-    avoid_single_cascade_in_expression_statements: true
-    avoid_types_on_closure_parameters: false
-    avoid_unnecessary_containers: false
-    avoid_unused_constructor_parameters: true
-    avoid_void_async: true
-    await_only_futures: true
-    camel_case_extensions: true
-    camel_case_types: true
-    cascade_invocations: true
-    cast_nullable_to_non_nullable: true
-    conditional_uri_does_not_exist: true
-    constant_identifier_names: true
-    curly_braces_in_flow_control_structures: true
-    deprecated_consistency: true
-    directives_ordering: true
-    do_not_use_environment: true
-    empty_catches: true
-    empty_constructor_bodies: true
-    eol_at_end_of_file: true
-    exhaustive_cases: true
-    file_names: true
-    flutter_style_todos: true
-    implementation_imports: true
-    join_return_with_assignment: true
-    leading_newlines_in_multiline_strings: true
-    library_names: true
-    library_prefixes: true
-    library_private_types_in_public_api: true
-    lines_longer_than_80_chars: true
-    missing_whitespace_between_adjacent_strings: true
-    no_default_cases: true
-    no_leading_underscores_for_library_prefixes: true
-    no_leading_underscores_for_local_identifiers: true
-    no_runtimeType_toString: true
-    non_constant_identifier_names: true
-    noop_primitive_operations: true
-    null_check_on_nullable_type_parameter: true
-    null_closures: true
-    omit_local_variable_types: true
-    one_member_abstracts: true
-    only_throw_errors: true
-    overridden_fields: true
-    package_api_docs: true
-    package_prefixed_library_names: true
-    parameter_assignments: true
-    prefer_adjacent_string_concatenation: true
-    prefer_asserts_in_initializer_lists: true
-    prefer_asserts_with_message: true
-    prefer_collection_literals: true
-    prefer_conditional_assignment: true
-    prefer_const_constructors: true
-    prefer_const_constructors_in_immutables: true
-    prefer_const_declarations: false
-    prefer_const_literals_to_create_immutables: false
-    prefer_constructors_over_static_methods: true
-    prefer_contains: true
-    prefer_double_quotes: false
-    prefer_equal_for_default_values: true
-    prefer_expression_function_bodies: false
-    prefer_final_fields: true
-    prefer_final_in_for_each: false
-    prefer_final_locals: false
-    prefer_final_parameters: false
-    prefer_for_elements_to_map_fromIterable: true
-    prefer_foreach: true
-    prefer_function_declarations_over_variables: true
-    prefer_generic_function_type_aliases: true
-    prefer_if_elements_to_conditional_expressions: true
-    prefer_if_null_operators: true
-    prefer_initializing_formals: true
-    prefer_inlined_adds: true
-    prefer_int_literals: false
-    prefer_interpolation_to_compose_strings: true
-    prefer_is_empty: true
-    prefer_is_not_empty: true
-    prefer_is_not_operator: true
-    prefer_iterable_whereType: true
-    prefer_mixin: true
-    prefer_null_aware_method_calls: true
-    prefer_null_aware_operators: true
-    prefer_single_quotes: true
-    prefer_spread_collections: true
-    prefer_typing_uninitialized_variables: true
-    provide_deprecation_message: true
-    public_member_api_docs: false
-    recursive_getters: true
-    require_trailing_commas: true
-    sized_box_for_whitespace: true
-    sized_box_shrink_expand: true
-    slash_for_doc_comments: true
-    sort_child_properties_last: true
-    sort_constructors_first: true
-    sort_unnamed_constructors_first: true
-    tighten_type_of_initializing_formals: true
-    type_annotate_public_apis: true
-    type_init_formals: true
-    unawaited_futures: true
-    unnecessary_await_in_return: true
-    unnecessary_brace_in_string_interps: true
-    unnecessary_const: false
-    unnecessary_constructor_name: true
-    unnecessary_final: true
-    unnecessary_getters_setters: true
-    unnecessary_lambdas: true
-    unnecessary_late: true
-    unnecessary_new: true
-    unnecessary_null_aware_assignments: true
-    unnecessary_null_checks: true
-    unnecessary_null_in_if_null_operators: true
-    unnecessary_nullable_for_final_variable_declarations: true
-    unnecessary_overrides: true
-    unnecessary_parenthesis: true
-    unnecessary_raw_strings: true
-    unnecessary_string_escapes: true
-    unnecessary_string_interpolations: true
-    unnecessary_this: true
-    use_decorated_box: true
-    use_full_hex_values_for_flutter_colors: true
-    use_function_type_syntax_for_parameters: true
-    use_if_null_to_convert_nulls_to_bools: true
-    use_is_even_rather_than_modulo: true
-    use_late_for_private_fields_and_variables: true
-    use_named_constants: true
-    use_raw_strings: false
-    use_rethrow_when_possible: true
-    use_setters_to_change_properties: true
-    use_string_buffers: true
-    use_test_throws_matchers: true
-    use_to_and_as_if_applicable: true
-    void_checks: true
-    # pub rules
-    depend_on_referenced_packages: true
-    lowercase_with_underscores: true
-    secure_pubspec_urls: false
-    sort_pub_dependencies: false
 
-# Additional information about this file can be found at
+linter:
-# https://dart.dev/guides/language/analysis-options
+  rules:

bitbucket-pipelines.yml

@@ -1,48 +0,0 @@
-# SPDX-FileCopyrightText: 2022 Iconica
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-
-image: cirrusci/flutter
-
-pipelines:
-  pull-requests:
-    feature/*:
-      - step:
-         caches:
-          - gradle
-          - gradlewrapper
-          - flutter
-         name: Run analyzer & test
-         script:
-          - flutter pub get
-          - flutter format -o none --set-exit-if-changed .
-          - flutter analyze
-
-    develop:
-      - step:
-         caches:
-          - gradle
-          - gradlewrapper
-          - flutter
-         name: Run analyzer & test
-         script:
-          - flutter pub get
-          - flutter format -o none --set-exit-if-changed .
-          - flutter analyze
-
-    hotfix/*:
-      - step:
-         caches:
-          - gradle
-          - gradlewrapper
-          - flutter
-         name: Run analyzer & test
-         script:
-          - flutter pub get
-          - flutter format -o none --set-exit-if-changed .
-          - flutter analyze
-
-definitions:
-  caches:
-    gradlewrapper: ~/.gradle/wrapper
-    flutter: ~/.pub-cache

example/analysis_options.yaml

@@ -1,218 +1,4 @@
-# SPDX-FileCopyrightText: 2022 Iconica
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-
 include: package:flutter_lints/flutter.yaml
-analyzer:
-  errors:
-    todo: ignore
-  exclude: [lib/generated_plugin_registrant.dart]
-linter:
-  # https://dart.dev/tools/linter-rules#lints
-  rules:
-    # error rules
-    always_use_package_imports: false
-    avoid_dynamic_calls: true
-    avoid_empty_else: true
-    avoid_print: true
-    avoid_relative_lib_imports: true
-    avoid_returning_null_for_future: true
-    avoid_slow_async_io: true
-    avoid_type_to_string: true
-    avoid_types_as_parameter_names: true
-    avoid_web_libraries_in_flutter: true
-    cancel_subscriptions: true
-    close_sinks: true
-    comment_references: false
-    control_flow_in_finally: true
-    diagnostic_describe_all_properties: false
-    empty_statements: true
-    hash_and_equals: true
-    invariant_booleans: true
-    iterable_contains_unrelated_type: true
-    list_remove_unrelated_type: true
-    literal_only_boolean_expressions: true
-    no_adjacent_strings_in_list: true
-    no_duplicate_case_values: true
-    no_logic_in_create_state: true
-    prefer_relative_imports: false
-    prefer_void_to_null: true
-    test_types_in_equals: true
-    throw_in_finally: true
-    unnecessary_statements: true
-    unrelated_type_equality_checks: true
-    unsafe_html: true
-    use_build_context_synchronously: true
-    use_key_in_widget_constructors: true
-    valid_regexps: true
-    # style rules
-    always_declare_return_types: true
-    always_put_control_body_on_new_line: true
-    always_put_required_named_parameters_first: true
-    always_require_non_null_named_parameters: true
-    always_specify_types: false
-    annotate_overrides: true
-    avoid_annotating_with_dynamic: false
-    avoid_bool_literals_in_conditional_expressions: true
-    avoid_catches_without_on_clauses: false
-    avoid_catching_errors: false
-    avoid_classes_with_only_static_members: true
-    avoid_double_and_int_checks: true
-    avoid_equals_and_hash_code_on_mutable_classes: false
-    avoid_escaping_inner_quotes: false
-    avoid_field_initializers_in_const_classes: true
-    avoid_final_parameters: true
-    avoid_function_literals_in_foreach_calls: true
-    avoid_implementing_value_types: true
-    avoid_init_to_null: true
-    avoid_js_rounded_ints: true
-    avoid_multiple_declarations_per_line: true
-    avoid_null_checks_in_equality_operators: true
-    avoid_positional_boolean_parameters: true
-    avoid_private_typedef_functions: true
-    avoid_redundant_argument_values: false
-    avoid_renaming_method_parameters: true
-    avoid_return_types_on_setters: true
-    avoid_returning_null: true
-    avoid_returning_null_for_void: true
-    avoid_returning_this: true
-    avoid_setters_without_getters: true
-    avoid_shadowing_type_parameters: true
-    avoid_single_cascade_in_expression_statements: true
-    avoid_types_on_closure_parameters: false
-    avoid_unnecessary_containers: false
-    avoid_unused_constructor_parameters: true
-    avoid_void_async: true
-    await_only_futures: true
-    camel_case_extensions: true
-    camel_case_types: true
-    cascade_invocations: true
-    cast_nullable_to_non_nullable: true
-    conditional_uri_does_not_exist: true
-    constant_identifier_names: true
-    curly_braces_in_flow_control_structures: true
-    deprecated_consistency: true
-    directives_ordering: true
-    do_not_use_environment: true
-    empty_catches: true
-    empty_constructor_bodies: true
-    eol_at_end_of_file: true
-    exhaustive_cases: true
-    file_names: true
-    flutter_style_todos: true
-    implementation_imports: true
-    join_return_with_assignment: true
-    leading_newlines_in_multiline_strings: true
-    library_names: true
-    library_prefixes: true
-    library_private_types_in_public_api: true
-    lines_longer_than_80_chars: true
-    missing_whitespace_between_adjacent_strings: true
-    no_default_cases: true
-    no_leading_underscores_for_library_prefixes: true
-    no_leading_underscores_for_local_identifiers: true
-    no_runtimeType_toString: true
-    non_constant_identifier_names: true
-    noop_primitive_operations: true
-    null_check_on_nullable_type_parameter: true
-    null_closures: true
-    omit_local_variable_types: true
-    one_member_abstracts: true
-    only_throw_errors: true
-    overridden_fields: true
-    package_api_docs: true
-    package_prefixed_library_names: true
-    parameter_assignments: true
-    prefer_adjacent_string_concatenation: true
-    prefer_asserts_in_initializer_lists: true
-    prefer_asserts_with_message: true
-    prefer_collection_literals: true
-    prefer_conditional_assignment: true
-    prefer_const_constructors: true
-    prefer_const_constructors_in_immutables: true
-    prefer_const_declarations: false
-    prefer_const_literals_to_create_immutables: false
-    prefer_constructors_over_static_methods: true
-    prefer_contains: true
-    prefer_double_quotes: false
-    prefer_equal_for_default_values: true
-    prefer_expression_function_bodies: false
-    prefer_final_fields: true
-    prefer_final_in_for_each: false
-    prefer_final_locals: false
-    prefer_final_parameters: false
-    prefer_for_elements_to_map_fromIterable: true
-    prefer_foreach: true
-    prefer_function_declarations_over_variables: true
-    prefer_generic_function_type_aliases: true
-    prefer_if_elements_to_conditional_expressions: true
-    prefer_if_null_operators: true
-    prefer_initializing_formals: true
-    prefer_inlined_adds: true
-    prefer_int_literals: false
-    prefer_interpolation_to_compose_strings: true
-    prefer_is_empty: true
-    prefer_is_not_empty: true
-    prefer_is_not_operator: true
-    prefer_iterable_whereType: true
-    prefer_mixin: true
-    prefer_null_aware_method_calls: true
-    prefer_null_aware_operators: true
-    prefer_single_quotes: true
-    prefer_spread_collections: true
-    prefer_typing_uninitialized_variables: true
-    provide_deprecation_message: true
-    public_member_api_docs: false
-    recursive_getters: true
-    require_trailing_commas: true
-    sized_box_for_whitespace: true
-    sized_box_shrink_expand: true
-    slash_for_doc_comments: true
-    sort_child_properties_last: true
-    sort_constructors_first: true
-    sort_unnamed_constructors_first: true
-    tighten_type_of_initializing_formals: true
-    type_annotate_public_apis: true
-    type_init_formals: true
-    unawaited_futures: true
-    unnecessary_await_in_return: true
-    unnecessary_brace_in_string_interps: true
-    unnecessary_const: false
-    unnecessary_constructor_name: true
-    unnecessary_final: true
-    unnecessary_getters_setters: true
-    unnecessary_lambdas: true
-    unnecessary_late: true
-    unnecessary_new: true
-    unnecessary_null_aware_assignments: true
-    unnecessary_null_checks: true
-    unnecessary_null_in_if_null_operators: true
-    unnecessary_nullable_for_final_variable_declarations: true
-    unnecessary_overrides: true
-    unnecessary_parenthesis: true
-    unnecessary_raw_strings: true
-    unnecessary_string_escapes: true
-    unnecessary_string_interpolations: true
-    unnecessary_this: true
-    use_decorated_box: true
-    use_full_hex_values_for_flutter_colors: true
-    use_function_type_syntax_for_parameters: true
-    use_if_null_to_convert_nulls_to_bools: true
-    use_is_even_rather_than_modulo: true
-    use_late_for_private_fields_and_variables: true
-    use_named_constants: true
-    use_raw_strings: false
-    use_rethrow_when_possible: true
-    use_setters_to_change_properties: true
-    use_string_buffers: true
-    use_test_throws_matchers: true
-    use_to_and_as_if_applicable: true
-    void_checks: true
-    # pub rules
-    depend_on_referenced_packages: true
-    lowercase_with_underscores: true
-    secure_pubspec_urls: false
-    sort_pub_dependencies: false
 
 # Additional information about this file can be found at
 # https://dart.dev/guides/language/analysis-options

example/android/build.gradle

@@ -26,6 +26,6 @@ subprojects {
     project.evaluationDependsOn(':app')
 }
 
-task clean(type: Delete) {
+tasks.register("clean", Delete) {
     delete rootProject.buildDir
 }

example/ios/Podfile

@@ -1,5 +1,5 @@
 # Uncomment this line to define a global platform for your project
-# platform :ios, '11.0'
+platform :ios, '11.0'
 
 # CocoaPods analytics sends network stats synchronously affecting flutter build latency.
 ENV['COCOAPODS_DISABLE_STATS'] = 'true'

example/lib/example_registration_repository.dart

@@ -9,8 +9,8 @@ import 'package:flutter_registration/flutter_registration.dart';
 
 class ExampleRegistrationRepository with RegistrationRepository {
   @override
-  Future<bool> register(HashMap values) {
+  Future<String?> register(HashMap values) {
     debugPrint('register: $values');
-    return Future.value(true);
+    return Future.value(null);
   }
 }

example/lib/main.dart

@@ -2,27 +2,81 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
+import 'package:flutter/gestures.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_registration/flutter_registration.dart';
 import 'example_registration_repository.dart';
 
 void main() {
   runApp(
-    const MaterialApp(
+    MaterialApp(
-      home: FlutterRegistrationDemo(),
+      theme: ThemeData(
+        inputDecorationTheme: const InputDecorationTheme(
+          errorStyle: TextStyle(color: Colors.red),
+        ),
+      ),
+      home: const FlutterRegistrationDemo(),
     ),
   );
 }
 
-class FlutterRegistrationDemo extends StatelessWidget {
+class FlutterRegistrationDemo extends StatefulWidget {
-  const FlutterRegistrationDemo({Key? key}) : super(key: key);
+  const FlutterRegistrationDemo({super.key});
+
+  @override
+  State<FlutterRegistrationDemo> createState() =>
+      _FlutterRegistrationDemoState();
+}
+
+class _FlutterRegistrationDemoState extends State<FlutterRegistrationDemo> {
+  late List<AuthStep> steps;
+
+  @override
+  void initState() {
+    super.initState();
+
+    steps = RegistrationOptions.getDefaultSteps();
+
+    steps[1].fields.add(
+          AuthBoolField(
+            name: 'termsConditions',
+            widgetType: BoolWidgetType.checkbox,
+            validators: [
+              (value) {
+                if (value == null || !value) {
+                  return 'Required';
+                }
+
+                return null;
+              },
+            ],
+            rightWidget: Text.rich(
+              TextSpan(
+                text: 'I agree with the ',
+                children: <TextSpan>[
+                  TextSpan(
+                    text: 'terms & conditions',
+                    style: const TextStyle(
+                      decoration: TextDecoration.underline,
+                    ),
+                    recognizer: TapGestureRecognizer()
+                      ..onTap = () {
+                        debugPrint('Open terms and conditions');
+                      },
+                  ),
+                ],
+              ),
+            ),
+          ),
+        );
+  }
 
   @override
   Widget build(BuildContext context) {
     return RegistrationScreen(
       registrationOptions: RegistrationOptions(
         registrationRepository: ExampleRegistrationRepository(),
-        registrationSteps: RegistrationOptions.getDefaultSteps(),
+        registrationSteps: steps,
         afterRegistration: () {
           debugPrint('Registered!');
         },
@@ -32,8 +86,7 @@ class FlutterRegistrationDemo extends StatelessWidget {
 }
 
 class ProtectedScreen extends StatelessWidget {
-  const ProtectedScreen({Key? key}) : super(key: key);
+  const ProtectedScreen({super.key});
-
   @override
   Widget build(BuildContext context) {
     return const Scaffold(

example/pubspec.lock

@@ -5,10 +5,10 @@ packages:
     dependency: transitive
     description:
       name: async
-      sha256: bfe67ef28df125b7dddcea62755991f807aa39a2492a23e1550161692950bbe0
+      sha256: "947bfcf187f74dbc5e146c9eb9c0f10c9f8b30743e341481c1e2ed3ecc18c20c"
       url: "https://pub.dev"
     source: hosted
-    version: "2.10.0"
+    version: "2.11.0"
   boolean_selector:
     dependency: transitive
     description:
@@ -21,10 +21,10 @@ packages:
     dependency: transitive
     description:
       name: characters
-      sha256: e6a326c8af69605aec75ed6c187d06b349707a27fbff8222ca9cc2cff167975c
+      sha256: "04a925763edad70e8443c99234dc3328f442e811f1d8fd1a72f1c8ad0f69a605"
       url: "https://pub.dev"
     source: hosted
-    version: "1.2.1"
+    version: "1.3.0"
   clock:
     dependency: transitive
     description:
@@ -37,18 +37,18 @@ packages:
     dependency: transitive
     description:
       name: collection
-      sha256: cfc915e6923fe5ce6e153b0723c753045de46de1b4d63771530504004a45fae0
+      sha256: ee67cb0715911d28db6bf4af1026078bd6f0128b07a5f66fb2ed94ec6783c09a
       url: "https://pub.dev"
     source: hosted
-    version: "1.17.0"
+    version: "1.18.0"
   cupertino_icons:
     dependency: "direct main"
     description:
       name: cupertino_icons
-      sha256: e35129dc44c9118cee2a5603506d823bab99c68393879edb440e0090d07586be
+      sha256: d57953e10f9f8327ce64a508a355f0b1ec902193f66288e8cb5070e7c47eeb2d
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.5"
+    version: "1.0.6"
   fake_async:
     dependency: transitive
     description:
@@ -62,22 +62,22 @@ packages:
     description: flutter
     source: sdk
     version: "0.0.0"
-  flutter_hooks:
+  flutter_input_library:
     dependency: transitive
     description:
-      name: flutter_hooks
+      name: flutter_input_library
-      sha256: "2b202559a4ed3656bbb7aae9d8b335fb0037b23acc7ae3f377d1ba0b95c21aec"
+      sha256: db8d9d57c31f166ed7c4ec3d060d18891533c57877a30c6c2668231efa1a44f8
-      url: "https://pub.dev"
+      url: "https://forgejo.internal.iconica.nl/api/packages/internal/pub/"
     source: hosted
-    version: "0.18.5+1"
+    version: "3.6.0"
   flutter_lints:
     dependency: "direct dev"
     description:
       name: flutter_lints
-      sha256: aeb0b80a8b3709709c9cc496cdc027c5b3216796bc0af0ce1007eaf24464fd4c
+      sha256: a25a15ebbdfc33ab1cd26c63a6ee519df92338a9c10f122adda92938253bef04
       url: "https://pub.dev"
     source: hosted
-    version: "2.0.1"
+    version: "2.0.3"
   flutter_localizations:
     dependency: transitive
     description: flutter
@@ -89,7 +89,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "0.2.0"
+    version: "2.0.4"
   flutter_test:
     dependency: "direct dev"
     description: flutter
@@ -99,58 +99,74 @@ packages:
     dependency: transitive
     description:
       name: intl
-      sha256: "910f85bce16fb5c6f614e117efa303e85a1731bb0081edf3604a2ae6e9a3cc91"
+      sha256: d6f56758b7d3014a48af9701c085700aac781a92a87a62b1333b46d8879661cf
       url: "https://pub.dev"
     source: hosted
-    version: "0.17.0"
+    version: "0.19.0"
-  js:
+  leak_tracker:
     dependency: transitive
     description:
-      name: js
+      name: leak_tracker
-      sha256: "5528c2f391ededb7775ec1daa69e65a2d61276f7552de2b5f7b8d34ee9fd4ab7"
+      sha256: "7f0df31977cb2c0b88585095d168e689669a2cc9b97c309665e3386f3e9d341a"
       url: "https://pub.dev"
     source: hosted
-    version: "0.6.5"
+    version: "10.0.4"
+  leak_tracker_flutter_testing:
+    dependency: transitive
+    description:
+      name: leak_tracker_flutter_testing
+      sha256: "06e98f569d004c1315b991ded39924b21af84cf14cc94791b8aea337d25b57f8"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.3"
+  leak_tracker_testing:
+    dependency: transitive
+    description:
+      name: leak_tracker_testing
+      sha256: "6ba465d5d76e67ddf503e1161d1f4a6bc42306f9d66ca1e8f079a47290fb06d3"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.1"
   lints:
     dependency: transitive
     description:
       name: lints
-      sha256: "5cfd6509652ff5e7fe149b6df4859e687fca9048437857cb2e65c8d780f396e3"
+      sha256: "0a217c6c989d21039f1498c3ed9f3ed71b354e69873f13a8dfc3c9fe76f1b452"
       url: "https://pub.dev"
     source: hosted
-    version: "2.0.0"
+    version: "2.1.1"
   matcher:
     dependency: transitive
     description:
       name: matcher
-      sha256: "16db949ceee371e9b99d22f88fa3a73c4e59fd0afed0bd25fc336eb76c198b72"
+      sha256: d2323aa2060500f906aa31a895b4030b6da3ebdcc5619d14ce1aada65cd161cb
       url: "https://pub.dev"
     source: hosted
-    version: "0.12.13"
+    version: "0.12.16+1"
   material_color_utilities:
     dependency: transitive
     description:
       name: material_color_utilities
-      sha256: d92141dc6fe1dad30722f9aa826c7fbc896d021d792f80678280601aff8cf724
+      sha256: "0e0a020085b65b6083975e499759762399b4475f766c21668c4ecca34ea74e5a"
       url: "https://pub.dev"
     source: hosted
-    version: "0.2.0"
+    version: "0.8.0"
   meta:
     dependency: transitive
     description:
       name: meta
-      sha256: "6c268b42ed578a53088d834796959e4a1814b5e9e164f147f580a386e5decf42"
+      sha256: "7687075e408b093f36e6bbf6c91878cc0d4cd10f409506f7bc996f68220b9136"
       url: "https://pub.dev"
     source: hosted
-    version: "1.8.0"
+    version: "1.12.0"
   path:
     dependency: transitive
     description:
       name: path
-      sha256: db9d4f58c908a4ba5953fcee2ae317c94889433e5024c27ce74a37f94267945b
+      sha256: "087ce49c3f0dc39180befefc60fdb4acd8f8620e5682fe2476afd0b3688bb4af"
       url: "https://pub.dev"
     source: hosted
-    version: "1.8.2"
+    version: "1.9.0"
   sky_engine:
     dependency: transitive
     description: flutter
@@ -160,26 +176,26 @@ packages:
     dependency: transitive
     description:
       name: source_span
-      sha256: dd904f795d4b4f3b870833847c461801f6750a9fa8e61ea5ac53f9422b31f250
+      sha256: "53e943d4206a5e30df338fd4c6e7a077e02254531b138a15aec3bd143c1a8b3c"
       url: "https://pub.dev"
     source: hosted
-    version: "1.9.1"
+    version: "1.10.0"
   stack_trace:
     dependency: transitive
     description:
       name: stack_trace
-      sha256: c3c7d8edb15bee7f0f74debd4b9c5f3c2ea86766fe4178eb2a18eb30a0bdaed5
+      sha256: "73713990125a6d93122541237550ee3352a2d84baad52d375a4cad2eb9b7ce0b"
       url: "https://pub.dev"
     source: hosted
-    version: "1.11.0"
+    version: "1.11.1"
   stream_channel:
     dependency: transitive
     description:
       name: stream_channel
-      sha256: "83615bee9045c1d322bbbd1ba209b7a749c2cbcdcb3fdd1df8eb488b3279c1c8"
+      sha256: ba2aa5d8cc609d96bbb2899c28934f9e1af5cddbd60a827822ea467161eb54e7
       url: "https://pub.dev"
     source: hosted
-    version: "2.1.1"
+    version: "2.1.2"
   string_scanner:
     dependency: transitive
     description:
@@ -200,10 +216,10 @@ packages:
     dependency: transitive
     description:
       name: test_api
-      sha256: ad540f65f92caa91bf21dfc8ffb8c589d6e4dc0c2267818b4cc2792857706206
+      sha256: "9955ae474176f7ac8ee4e989dadfb411a58c30415bcfb648fa04b2b8a03afa7f"
       url: "https://pub.dev"
     source: hosted
-    version: "0.4.16"
+    version: "0.7.0"
   vector_math:
     dependency: transitive
     description:
@@ -212,6 +228,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.1.4"
+  vm_service:
+    dependency: transitive
+    description:
+      name: vm_service
+      sha256: "3923c89304b715fb1eb6423f017651664a03bf5f4b29983627c4da791f74a4ec"
+      url: "https://pub.dev"
+    source: hosted
+    version: "14.2.1"
 sdks:
-  dart: ">=2.18.0 <3.0.0"
+  dart: ">=3.3.0 <4.0.0"
-  flutter: ">=3.0.0"
+  flutter: ">=3.18.0-18.0.pre.54"

lib/flutter_registration.dart

@@ -1,14 +1,21 @@
 // SPDX-FileCopyrightText: 2022 Iconica
 //
 // SPDX-License-Identifier: BSD-3-Clause
-
+/// Flutter registration component that provides a registration
+/// screen with multiple registration steps.
 library flutter_registration;
 
-export 'src/config/registration_options.dart';
+export "package:flutter_input_library/flutter_input_library.dart"
-export 'src/config/registration_translations.dart';
+    show BoolWidgetType;
-export 'src/model/auth_exception.dart';
+
-export 'src/model/auth_field.dart';
+export "src/config/registration_options.dart";
-export 'src/model/auth_step.dart';
+export "src/config/registration_translations.dart";
-export 'src/model/auth_text_field.dart';
+export "src/model/auth_bool_field.dart";
-export 'src/registration_screen.dart';
+export "src/model/auth_drop_down.dart";
-export 'src/service/registration_repository.dart';
+export "src/model/auth_exception.dart";
+export "src/model/auth_field.dart";
+export "src/model/auth_pass_field.dart";
+export "src/model/auth_step.dart";
+export "src/model/auth_text_field.dart";
+export "src/registration_screen.dart";
+export "src/service/registration_repository.dart";

lib/src/auth_screen.dart

@@ -2,64 +2,171 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
-import 'dart:collection';
+import "dart:async";
-import 'package:flutter/material.dart';
+import "dart:collection";
-import 'package:flutter_registration/src/model/auth_field.dart';
+import "package:flutter/material.dart";
-import 'package:flutter_registration/src/model/auth_step.dart';
+import "package:flutter_registration/flutter_registration.dart";
 
+/// A widget for handling multi-step authentication processes.
 class AuthScreen extends StatefulWidget {
+  /// Constructs an [AuthScreen] object.
+  ///
+  /// [appBarTitle] specifies the title of the app bar.
+  ///
+  /// [onFinish] is a function called upon
+  /// completion of the authentication process.
+  ///
+  /// [steps] is a list of authentication steps to be completed.
+  ///
+  /// [submitBtnTitle] specifies the title of the submit button.
+  ///
+  /// [nextBtnTitle] specifies the title of the next button.
+  ///
+  /// [previousBtnTitle] specifies the title of the previous button.
+  ///
+  /// [customAppBar] allows customization of the app bar.
+  ///
+  /// [buttonMainAxisAlignment] specifies the alignment of the buttons.
+  ///
+  /// [customBackgroundColor] allows customization of the background color.
+  ///
+  /// [nextButtonBuilder] allows customization of the next button.
+  ///
+  /// [previousButtonBuilder] allows customization of the previous button.
+  ///
+  /// [titleWidget] specifies a custom widget
+  /// to be displayed at the top of the screen.
+  ///
+  /// [loginButton] specifies a custom login button widget.
+  ///
+  /// [titleFlex] specifies the flex value for the title widget.
+  ///
+  /// [formFlex] specifies the flex value for the form widget.
+  ///
+  /// [beforeTitleFlex] specifies the flex value before the title widget.
+  ///
+  /// [afterTitleFlex] specifies the flex value after the title widget.
+
   const AuthScreen({
-    required this.title,
+    required this.appBarTitle,
     required this.steps,
     required this.submitBtnTitle,
     required this.nextBtnTitle,
     required this.previousBtnTitle,
     required this.onFinish,
     this.customAppBar,
+    this.buttonMainAxisAlignment,
+    this.customBackgroundColor,
     this.nextButtonBuilder,
     this.previousButtonBuilder,
+    this.titleWidget,
+    this.loginButton,
+    this.titleFlex,
+    this.formFlex,
+    this.beforeTitleFlex,
+    this.afterTitleFlex,
+    this.maxFormWidth,
     super.key,
-  }) : assert(steps.length > 0, 'At least one step is required');
+  }) : assert(steps.length > 0, "At least one step is required");
 
-  final String title;
+  /// The title of the app bar.
-  final Function({
+  final String appBarTitle;
-    required HashMap<String, String> values,
+
-    required VoidCallback onError,
+  /// A function called upon completion of the authentication process.
+  final Future<void> Function({
+    required HashMap<String, dynamic> values,
+    required void Function(int? pageToReturn) onError,
   }) onFinish;
+
+  /// The authentication steps to be completed.
   final List<AuthStep> steps;
+
+  /// The title of the submit button.
   final String submitBtnTitle;
+
+  /// The title of the next button.
   final String nextBtnTitle;
+
+  /// The title of the previous button.
   final String previousBtnTitle;
+
+  /// A custom app bar widget.
   final AppBar? customAppBar;
-  final Widget Function(VoidCallback onPressed, String label)?
+
-      nextButtonBuilder;
+  /// The alignment of the buttons.
-  final Widget Function(VoidCallback onPressed, String label)?
+  final MainAxisAlignment? buttonMainAxisAlignment;
+
+  /// The background color of the screen.
+  final Color? customBackgroundColor;
+
+  /// A custom widget for the button.
+  final Widget Function(
+    Future<void> Function()? onPressed,
+    String label,
+    int step,
+    // ignore: avoid_positional_boolean_parameters
+    bool enabled,
+  )? nextButtonBuilder;
+
+  /// A custom widget for the button.
+  final Widget? Function(VoidCallback onPressed, String label, int step)?
       previousButtonBuilder;
 
+  /// A custom widget for the title.
+  final Widget? titleWidget;
+
+  /// A custom widget for the login button.
+  final Widget? loginButton;
+
+  /// The flex value for the title widget.
+  final int? titleFlex;
+
+  /// The flex value for the form widget.
+  final int? formFlex;
+
+  /// The flex value before the title widget.
+  final int? beforeTitleFlex;
+
+  /// The flex value after the title widget.
+  final int? afterTitleFlex;
+
+  /// The maximum width of the form.
+  final double? maxFormWidth;
+
   @override
   State<AuthScreen> createState() => _AuthScreenState();
 }
 
+/// The state for [AuthScreen].
 class _AuthScreenState extends State<AuthScreen> {
   final _formKey = GlobalKey<FormState>();
   final _pageController = PageController();
   final _animationDuration = const Duration(milliseconds: 300);
   final _animationCurve = Curves.ease;
+  bool _formValid = false;
 
+  /// Gets the app bar.
   AppBar get _appBar =>
       widget.customAppBar ??
       AppBar(
-        title: Text(widget.title),
+        backgroundColor: const Color(0xffFAF9F6),
+        title: Text(widget.appBarTitle),
       );
 
+  /// Handles previous button press.
   void onPrevious() {
-    _pageController.previousPage(
+    FocusScope.of(context).unfocus();
-      duration: _animationDuration,
+    _validate(_pageController.page!.toInt() - 1);
-      curve: _animationCurve,
+    unawaited(
+      _pageController.previousPage(
+        duration: _animationDuration,
+        curve: _animationCurve,
+      ),
     );
   }
 
-  void onNext(AuthStep step) {
+  /// Handles next button press.
+  Future<void> onNext(AuthStep step) async {
     if (!_formKey.currentState!.validate()) {
       return;
     }
@@ -69,7 +176,7 @@ class _AuthScreenState extends State<AuthScreen> {
     FocusScope.of(context).unfocus();
 
     if (widget.steps.last == step) {
-      var values = HashMap<String, String>();
+      var values = HashMap<String, dynamic>();
 
       for (var step in widget.steps) {
         for (var field in step.fields) {
@@ -77,131 +184,238 @@ class _AuthScreenState extends State<AuthScreen> {
         }
       }
 
-      widget.onFinish(
+      await widget.onFinish(
         values: values,
-        onError: () => _pageController.animateToPage(
+        onError: (int? pageToReturn) {
-          0,
+          if (pageToReturn == null) {
-          duration: _animationDuration,
+            return;
-          curve: _animationCurve,
+          }
-        ),
+          _pageController.animateToPage(
+            pageToReturn,
+            duration: _animationDuration,
+            curve: _animationCurve,
+          );
+        },
       );
 
       return;
     } else {
-      _pageController.nextPage(
+      _validate(_pageController.page!.toInt() + 1);
-        duration: _animationDuration,
+      unawaited(
-        curve: _animationCurve,
+        _pageController.nextPage(
+          duration: _animationDuration,
+          curve: _animationCurve,
+        ),
       );
     }
   }
 
+  /// Validates the current step.
+  void _validate(int currentPage) {
+    var isStepValid = true;
+
+    // Loop through each field in the current step
+    for (var field in widget.steps[currentPage].fields) {
+      for (var validator in field.validators) {
+        var validationResult = validator(field.value);
+        if (validationResult != null) {
+          // If any validator returns an error, mark step as invalid and break
+          isStepValid = false;
+          break;
+        }
+      }
+      if (!isStepValid) {
+        break; // No need to check further fields if one is already invalid
+      }
+    }
+
+    setState(() {
+      _formValid = isStepValid;
+    });
+  }
+
   @override
-  Widget build(BuildContext context) => Scaffold(
+  Widget build(BuildContext context) {
-        backgroundColor: Theme.of(context).colorScheme.background,
+    var theme = Theme.of(context);
-        appBar: _appBar,
+    return Scaffold(
-        body: Form(
+      backgroundColor: widget.customBackgroundColor ?? const Color(0xffFAF9F6),
+      appBar: _appBar,
+      body: SafeArea(
+        child: Form(
           key: _formKey,
           child: PageView(
             physics: const NeverScrollableScrollPhysics(),
             controller: _pageController,
             children: <Widget>[
-              for (AuthStep step in widget.steps)
+              for (var currentStep = 0;
+                  currentStep < widget.steps.length;
+                  currentStep++)
                 Column(
+                  mainAxisSize: MainAxisSize.min,
                   mainAxisAlignment: MainAxisAlignment.spaceBetween,
                   children: [
-                    Flexible(
+                    if (widget.titleWidget != null) ...[
-                      child: Center(
+                      Expanded(
-                        child: ListView(
+                        flex: widget.titleFlex ?? 1,
-                          physics: const ClampingScrollPhysics(),
+                        child: Column(
-                          shrinkWrap: true,
+                          mainAxisAlignment: MainAxisAlignment.start,
-                          padding: const EdgeInsets.symmetric(
+                          mainAxisSize: MainAxisSize.min,
-                            vertical: 8.0,
-                            horizontal: 30.0,
-                          ),
                           children: [
-                            for (AuthField field in step.fields)
+                            Expanded(
-                              Align(
+                              flex: widget.beforeTitleFlex ?? 2,
-                                child: Column(
+                              child: Container(),
-                                  crossAxisAlignment: CrossAxisAlignment.start,
+                            ),
-                                  children: [
+                            widget.titleWidget!,
-                                    if (field.title != null) ...[
+                            Expanded(
-                                      field.title!,
+                              flex: widget.afterTitleFlex ?? 2,
-                                    ],
+                              child: Container(),
-                                    field.build(),
+                            ),
-                                  ],
-                                ),
-                              )
                           ],
                         ),
                       ),
-                    ),
+                    ],
-                    Padding(
+                    Expanded(
-                      padding: const EdgeInsets.only(
+                      flex: widget.formFlex ?? 3,
-                        top: 15.0,
+                      child: Align(
-                        bottom: 30.0,
+                        alignment: Alignment.topCenter,
-                        left: 30.0,
+                        child: ConstrainedBox(
-                        right: 30.0,
+                          constraints: BoxConstraints(
-                      ),
+                            maxWidth: widget.maxFormWidth ?? 300,
-                      child: Row(
+                          ),
-                        mainAxisAlignment: widget.steps.first != step
+                          child: Column(
-                            ? MainAxisAlignment.spaceBetween
+                            children: [
-                            : MainAxisAlignment.end,
+                              for (AuthField field
-                        children: [
+                                  in widget.steps[currentStep].fields) ...[
-                          if (widget.steps.first != step)
+                                if (field.title != null) ...[
-                            widget.previousButtonBuilder?.call(
+                                  wrapWithDefaultStyle(
-                                  onPrevious,
+                                    style: theme.textTheme.headlineLarge!,
-                                  widget.previousBtnTitle,
+                                    widget: field.title!,
-                                ) ??
-                                ElevatedButton(
-                                  onPressed: onPrevious,
-                                  child: Row(
-                                    children: [
-                                      const Icon(
-                                        Icons.arrow_back,
-                                        size: 18,
-                                      ),
-                                      Padding(
-                                        padding:
-                                            const EdgeInsets.only(left: 4.0),
-                                        child: Text(widget.previousBtnTitle),
-                                      ),
-                                    ],
                                   ),
-                                ),
+                                ],
-                          widget.nextButtonBuilder?.call(
+                                field.build(context, () {
-                                () => onNext(step),
+                                  _validate(currentStep);
-                                widget.steps.last == step
+                                }),
-                                    ? widget.submitBtnTitle
+                              ],
-                                    : widget.nextBtnTitle,
+                            ],
-                              ) ??
+                          ),
-                              ElevatedButton(
+                        ),
-                                onPressed: () {
+                      ),
-                                  onNext(step);
+                    ),
-                                },
+                    Column(
-                                child: Row(
+                      children: [
-                                  children: [
+                        SizedBox(
-                                    Text(
+                          width: MediaQuery.of(context).size.width,
-                                      widget.steps.last == step
+                          child: Padding(
+                            padding: const EdgeInsets.symmetric(
+                              horizontal: 20,
+                            ),
+                            child: Row(
+                              mainAxisAlignment: widget.steps.first !=
+                                      widget.steps[currentStep]
+                                  ? MainAxisAlignment.spaceBetween
+                                  : MainAxisAlignment.end,
+                              children: [
+                                if (widget.steps.first !=
+                                    widget.steps[currentStep]) ...[
+                                  widget.previousButtonBuilder?.call(
+                                        onPrevious,
+                                        widget.previousBtnTitle,
+                                        currentStep,
+                                      ) ??
+                                      _stepButton(
+                                        buttonText: widget.previousBtnTitle,
+                                        onTap: () async => onPrevious(),
+                                      ),
+                                  const SizedBox(
+                                    width: 8,
+                                  ),
+                                ],
+                                widget.nextButtonBuilder?.call(
+                                      !_formValid
+                                          ? null
+                                          : () async {
+                                              await onNext(
+                                                widget.steps[currentStep],
+                                              );
+                                            },
+                                      widget.steps.last ==
+                                              widget.steps[currentStep]
                                           ? widget.submitBtnTitle
                                           : widget.nextBtnTitle,
+                                      currentStep,
+                                      _formValid,
+                                    ) ??
+                                    _stepButton(
+                                      buttonText: widget.steps.last ==
+                                              widget.steps[currentStep]
+                                          ? widget.submitBtnTitle
+                                          : widget.nextBtnTitle,
+                                      onTap: () async {
+                                        await onNext(
+                                          widget.steps[currentStep],
+                                        );
+                                      },
                                     ),
-                                    const Padding(
+                              ],
-                                      padding: EdgeInsets.only(left: 4.0),
+                            ),
-                                      child: Icon(
+                          ),
-                                        Icons.arrow_forward,
+                        ),
-                                        size: 18,
+                        const SizedBox(
-                                      ),
+                          height: 8,
-                                    ),
+                        ),
-                                  ],
+                        if (widget.loginButton != null)
-                                ),
+                          Padding(
-                              ),
+                            padding: const EdgeInsets.only(top: 20.0),
-                        ],
+                            child: widget.loginButton,
-                      ),
+                          ),
-                    )
+                      ],
+                    ),
                   ],
                 ),
             ],
           ),
         ),
-      );
+      ),
+    );
+  }
+
+  Widget _stepButton({
+    required String buttonText,
+    required Future Function()? onTap,
+  }) {
+    var theme = Theme.of(context);
+    return Flexible(
+      child: InkWell(
+        onTap: onTap,
+        child: Container(
+          width: double.infinity,
+          constraints: const BoxConstraints(
+            maxWidth: 180,
+          ),
+          decoration: BoxDecoration(
+            borderRadius: BorderRadius.circular(20),
+            border: Border.all(
+              color: const Color(
+                0xff979797,
+              ),
+            ),
+          ),
+          child: Padding(
+            padding: const EdgeInsets.all(4),
+            child: Text(
+              buttonText,
+              style: theme.textTheme.bodyMedium,
+              textAlign: TextAlign.center,
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+
+  Widget wrapWithDefaultStyle({
+    required Widget widget,
+    required TextStyle style,
+  }) =>
+      DefaultTextStyle(style: style, child: widget);
 }

lib/src/config/example_registration_repository.dart

@@ -0,0 +1,12 @@
+import "dart:collection";
+import "package:flutter/material.dart";
+import "package:flutter_registration/flutter_registration.dart";
+
+/// A registration repository that does nothing.
+class ExampleRegistrationRepository with RegistrationRepository {
+  @override
+  Future<String?> register(HashMap values) {
+    debugPrint("register $values");
+    return Future.value(null);
+  }
+}

lib/src/config/registration_options.dart

@@ -2,120 +2,227 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
-import 'package:flutter/material.dart';
+import "dart:async";
-import 'package:flutter_registration/flutter_registration.dart';
 
+import "package:flutter/material.dart";
+import "package:flutter_registration/flutter_registration.dart";
+import "package:flutter_registration/src/config/example_registration_repository.dart";
+
+/// A set of options for configuring the
+/// registration process in a Flutter application.
 class RegistrationOptions {
+  /// Registration options Constructor
   RegistrationOptions({
-    required this.registrationRepository,
-    required this.registrationSteps,
     required this.afterRegistration,
-    this.registrationTranslations = const RegistrationTranslations(),
+    this.registrationRepository,
-    this.customAppbarBuilder,
+    this.registrationSteps,
+    this.titleFlex,
+    this.formFlex,
+    this.beforeTitleFlex,
+    this.afterTitleFlex,
+    this.registrationTranslations = const RegistrationTranslations.empty(),
+    this.onError,
+    this.customAppbarBuilder = _createCustomAppBar,
     this.nextButtonBuilder,
     this.previousButtonBuilder,
-  });
+    this.buttonMainAxisAlignment,
+    this.backgroundColor,
+    this.titleWidget,
+    this.loginButton,
+    this.maxFormWidth,
+    this.beforeRegistration,
+  }) {
+    if (registrationSteps == null || registrationSteps!.isEmpty) {
+      steps = RegistrationOptions.getDefaultSteps();
+    } else {
+      steps = registrationSteps!;
+    }
+    registrationRepository ??= ExampleRegistrationRepository();
+  }
 
+  /// Translations for registration-related messages and prompts.
   final RegistrationTranslations registrationTranslations;
-  final List<AuthStep> registrationSteps;
+
+  /// The steps involved in the registration process.
+  final List<AuthStep>? registrationSteps;
+
+  /// The steps involved in the registration process.
+  List<AuthStep> steps = [];
+
+  /// A function that handles errors during registration.
+  final int? Function(String error)? onError;
+
+  /// A callback function executed after successful registration.
   final VoidCallback afterRegistration;
-  final RegistrationRepository registrationRepository;
+
+  /// The repository responsible for registration.
+  RegistrationRepository? registrationRepository;
+
+  /// A function for customizing the app bar displayed during registration.
   final AppBar Function(String title)? customAppbarBuilder;
-  final Widget Function(VoidCallback onPressed, String label)?
+
-      nextButtonBuilder;
+  /// A function for customizing the "Next" button.
-  final Widget Function(VoidCallback onPressed, String label)?
+  final Widget Function(
+    Future<void> Function()? onPressed,
+    String label,
+    int step,
+    // ignore: avoid_positional_boolean_parameters
+    bool enabled,
+  )? nextButtonBuilder;
+
+  /// A function for customizing the "Previous" button.
+  final Widget? Function(VoidCallback onPressed, String label, int step)?
       previousButtonBuilder;
 
+  /// Specifies the alignment of buttons.
+  final MainAxisAlignment? buttonMainAxisAlignment;
+
+  /// The background color of the registration screen.
+  final Color? backgroundColor;
+
+  /// A custom widget for displaying the registration title.
+  final Widget? titleWidget;
+
+  /// A custom widget for displaying a login button.
+  final Widget? loginButton;
+
+  /// The number of flex units for the title.
+  final int? titleFlex;
+
+  /// The number of flex units for the form.
+  final int? formFlex;
+
+  /// The number of flex units for the buttons.
+  final int? beforeTitleFlex;
+
+  /// The number of flex units for the buttons.
+  final int? afterTitleFlex;
+
+  /// The maximum width of the form. Defaults to 300.
+  final double? maxFormWidth;
+
+  /// This function gets called before the user gets registered.
+  final Future<void> Function()? beforeRegistration;
+
+  /// Generates default registration steps.
+  ///
+  /// [emailController] controller for email input.
+  ///
+  /// [pass1Controller] controller for first password input.
+  ///
+  /// [pass1Hidden] whether the first password field is initially hidden.
+  ///
+  /// [pass2Controller] controller for second password input.
+  ///
+  /// [pass2Hidden] whether the second password field is initially hidden.
+  ///
+  /// [passHideOnChange] function triggered when password visibility changes.
+  ///
+  /// [translations] translations for default registration messages and prompts.
+  ///
+  /// [titleBuilder] function for customizing step titles.
+  ///
+  /// [labelBuilder] function for customizing field labels.
+  ///
+  /// [textStyle] text style for input fields.
+  ///
+  /// [initialEmail] initial value for email input.
   static List<AuthStep> getDefaultSteps({
-    RegistrationTranslations translations = const RegistrationTranslations(),
+    TextEditingController? emailController,
+    TextEditingController? passController,
+    bool passHidden = true,
+    // ignore: avoid_positional_boolean_parameters
+    Function(bool mainPass, bool value)? passHideOnChange,
+    RegistrationTranslations translations =
+        const RegistrationTranslations.empty(),
     Function(String title)? titleBuilder,
     Function(String label)? labelBuilder,
     TextStyle? textStyle,
-  }) {
+    TextStyle? hintStyle,
-    var password1 = '';
+    String? initialEmail,
-
+  }) =>
-    return [
+      [
-      AuthStep(
+        AuthStep(
-        fields: [
+          fields: [
-          AuthTextField(
+            AuthTextField(
-            name: 'email',
+              name: "email",
-            title: titleBuilder?.call(
+              textEditingController: emailController,
-                  translations.defaultEmailTitle,
+              value: initialEmail ?? "",
-                ) ??
+              title: titleBuilder?.call(translations.defaultEmailTitle) ??
-                Padding(
+                  Padding(
-                  padding: const EdgeInsets.only(
+                    padding: const EdgeInsets.only(top: 180),
-                    top: 24.0,
+                    child: Text(
-                    bottom: 12.0,
+                      translations.defaultEmailTitle,
-                  ),
-                  child: Text(
-                    translations.defaultEmailTitle,
-                    style: const TextStyle(
-                      fontWeight: FontWeight.bold,
                     ),
                   ),
-                ),
+              textInputType: TextInputType.emailAddress,
-            label: labelBuilder?.call(translations.defaultEmailLabel),
+              textFieldDecoration: InputDecoration(
-            hintText: translations.defaultEmailHint,
+                hintStyle: hintStyle,
-            textStyle: textStyle,
+                contentPadding: const EdgeInsets.symmetric(horizontal: 8),
-            validators: [
+                label: labelBuilder?.call(translations.defaultEmailLabel),
-              (email) => (email == null || email.isEmpty)
+                hintText: translations.defaultEmailHint,
-                  ? translations.defaultEmailEmpty
+                border: const OutlineInputBorder(),
-                  : null,
+                focusedBorder: const OutlineInputBorder(),
-              (email) =>
+              ),
-                  RegExp(r"""(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])""")
+              textStyle: textStyle,
-                          .hasMatch(email!)
+              padding: const EdgeInsets.symmetric(vertical: 20),
-                      ? null
+              validators: [
-                      : translations.defaultEmailValidatorMessage,
+                // ignore: avoid_dynamic_calls
-            ],
+                (email) => (email == null || email.isEmpty)
-          )
+                    ? translations.defaultEmailEmpty
-        ],
+                    : null,
-      ),
+                (email) =>
-      AuthStep(
+                    RegExp(r"""(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])""")
-        fields: [
+                            .hasMatch(email!)
-          AuthTextField(
+                        ? null
-            name: 'password1',
+                        : translations.defaultEmailValidatorMessage,
-            title: titleBuilder?.call(
+              ],
-                  translations.defaultPassword1Title,
+            ),
-                ) ??
+          ],
-                Padding(
+        ),
-                  padding: const EdgeInsets.only(
+        AuthStep(
-                    top: 24.0,
+          fields: [
-                    bottom: 12.0,
+            AuthPassField(
-                  ),
+              name: "password",
-                  child: Text(
+              textEditingController: passController,
-                    translations.defaultPassword1Title,
+              title: titleBuilder?.call(translations.defaultPasswordTitle) ??
-                    style: const TextStyle(
+                  Padding(
-                      fontWeight: FontWeight.bold,
+                    padding: const EdgeInsets.only(top: 180),
+                    child: Text(
+                      translations.defaultPasswordTitle,
                     ),
                   ),
-                ),
+              textFieldDecoration: InputDecoration(
-            label: labelBuilder?.call(translations.defaultPassword1Label),
+                hintStyle: hintStyle,
-            hintText: translations.defaultPassword1Hint,
+                contentPadding: const EdgeInsets.symmetric(horizontal: 8),
-            textStyle: textStyle,
+                label: labelBuilder?.call(translations.defaultPasswordLabel),
-            obscureText: true,
+                hintText: translations.defaultPasswordHint,
-            validators: [
+                border: const OutlineInputBorder(),
-              (value) => (value == null || value.isEmpty)
+                focusedBorder: const OutlineInputBorder(),
-                  ? translations.defaultPassword1ValidatorMessage
+              ),
-                  : null,
+              padding: const EdgeInsets.symmetric(vertical: 20),
-            ],
+              textStyle: textStyle,
-            onChange: (value) {
+              validators: [
-              password1 = value;
+                (value) {
-            },
+                  // ignore: avoid_dynamic_calls
-          ),
+                  if (value == null || value.isEmpty) {
-          AuthTextField(
+                    return translations.defaultPasswordValidatorMessage;
-            name: 'password2',
+                  }
-            label: labelBuilder?.call(translations.defaultPassword2Label),
+                  // ignore: avoid_dynamic_calls
-            hintText: translations.defaultPassword2Hint,
+                  if (value.length < 6) {
-            textStyle: textStyle,
+                    return translations.defaultPasswordToShortValidatorMessage;
-            obscureText: true,
+                  }
-            validators: [
+                  return null;
-              (value) => (value != password1)
+                },
-                  ? translations.defaultPassword2ValidatorMessage
+              ],
-                  : null,
+            ),
-            ],
+          ],
-          ),
+        ),
-        ],
+      ];
-      ),
-    ];
-  }
 }
+
+AppBar _createCustomAppBar(String title) => AppBar(
+      iconTheme: const IconThemeData(color: Colors.black, size: 16),
+      title: Text(title),
+      backgroundColor: Colors.transparent,
+    );

lib/src/config/registration_translations.dart

@@ -2,42 +2,129 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
+/// Holds all the translations for the standard elements
+/// on the registration screen.
 class RegistrationTranslations {
+  /// Constructs a [RegistrationTranslations] object.
   const RegistrationTranslations({
-    this.title = 'Registreren',
+    required this.title,
-    this.registerBtn = 'Registreren',
+    required this.registerBtn,
-    this.previousStepBtn = 'Vorige stap',
+    required this.previousStepBtn,
-    this.nextStepBtn = 'Volgende stap',
+    required this.nextStepBtn,
-    this.closeBtn = 'Sluiten',
+    required this.closeBtn,
-    this.defaultEmailTitle = 'Wat is je e-mailadres?',
+    required this.defaultEmailTitle,
-    this.defaultEmailLabel = '',
+    required this.defaultEmailLabel,
-    this.defaultEmailHint = 'iemand@voorbeeld.nl',
+    required this.defaultEmailHint,
-    this.defaultEmailEmpty = 'Geef uw e-mailadres op',
+    required this.defaultEmailEmpty,
-    this.defaultEmailValidatorMessage = 'Geef een geldig e-mailadres op',
+    required this.defaultEmailValidatorMessage,
-    this.defaultPassword1Title = 'Kies een wachtwoord',
+    required this.defaultPasswordTitle,
-    this.defaultPassword1Label = '',
+    required this.defaultPasswordLabel,
-    this.defaultPassword1Hint = '',
+    required this.defaultPasswordHint,
-    this.defaultPassword1ValidatorMessage = 'Geef een wachtwoord op',
+    required this.defaultPasswordValidatorMessage,
-    this.defaultPassword2Label = '',
+    required this.defaultPasswordToShortValidatorMessage,
-    this.defaultPassword2Hint = '',
-    this.defaultPassword2ValidatorMessage = 'Wachtwoorden moeten gelijk zijn',
   });
 
+  /// Constructs a [RegistrationTranslations] object with empty strings.
+  const RegistrationTranslations.empty()
+      : title = "",
+        registerBtn = "Register",
+        previousStepBtn = "Previous",
+        nextStepBtn = "Next",
+        closeBtn = "Close",
+        defaultEmailTitle = "enter your email address",
+        defaultEmailLabel = "",
+        defaultEmailHint = "Email address",
+        defaultEmailEmpty = "Please enter your email address.",
+        defaultEmailValidatorMessage = "Please enter a valid email address.",
+        defaultPasswordTitle = "choose a password",
+        defaultPasswordLabel = "",
+        defaultPasswordHint = "Password",
+        defaultPasswordValidatorMessage = "Enter a valid password",
+        defaultPasswordToShortValidatorMessage =
+            "Password needs to be at least 6 characters long";
+
+  /// The title of the registration screen.
   final String title;
+
+  /// The text for the registration button.
   final String registerBtn;
+
+  /// The text for the previous step button.
   final String previousStepBtn;
+
+  /// The text for the next step button.
   final String nextStepBtn;
+
+  /// The text for the close button.
   final String closeBtn;
+
+  /// The title for the default email field.
   final String defaultEmailTitle;
+
+  /// The label for the default email field.
   final String defaultEmailLabel;
+
+  /// The hint for the default email field.
   final String defaultEmailHint;
+
+  /// The message for an empty default email field.
   final String defaultEmailEmpty;
+
+  /// The message for an invalid default email field.
   final String defaultEmailValidatorMessage;
-  final String defaultPassword1Title;
+
-  final String defaultPassword1Label;
+  /// The title for the default password field.
-  final String defaultPassword1Hint;
+  final String defaultPasswordTitle;
-  final String defaultPassword1ValidatorMessage;
+
-  final String defaultPassword2Label;
+  /// The label for the default password field.
-  final String defaultPassword2Hint;
+  final String defaultPasswordLabel;
-  final String defaultPassword2ValidatorMessage;
+
+  /// The hint for the default password field.
+  final String defaultPasswordHint;
+
+  /// The message for an invalid default password field.
+  final String defaultPasswordValidatorMessage;
+
+  /// The message for a default password that is too short.
+  final String defaultPasswordToShortValidatorMessage;
+
+  /// create a copywith
+  RegistrationTranslations copyWith({
+    String? title,
+    String? registerBtn,
+    String? previousStepBtn,
+    String? nextStepBtn,
+    String? closeBtn,
+    String? defaultEmailTitle,
+    String? defaultEmailLabel,
+    String? defaultEmailHint,
+    String? defaultEmailEmpty,
+    String? defaultEmailValidatorMessage,
+    String? defaultPasswordTitle,
+    String? defaultPasswordLabel,
+    String? defaultPasswordHint,
+    String? defaultPasswordValidatorMessage,
+    String? defaultPasswordToShortValidatorMessage,
+  }) =>
+      RegistrationTranslations(
+        title: title ?? this.title,
+        registerBtn: registerBtn ?? this.registerBtn,
+        previousStepBtn: previousStepBtn ?? this.previousStepBtn,
+        nextStepBtn: nextStepBtn ?? this.nextStepBtn,
+        closeBtn: closeBtn ?? this.closeBtn,
+        defaultEmailTitle: defaultEmailTitle ?? this.defaultEmailTitle,
+        defaultEmailLabel: defaultEmailLabel ?? this.defaultEmailLabel,
+        defaultEmailHint: defaultEmailHint ?? this.defaultEmailHint,
+        defaultEmailEmpty: defaultEmailEmpty ?? this.defaultEmailEmpty,
+        defaultEmailValidatorMessage:
+            defaultEmailValidatorMessage ?? this.defaultEmailValidatorMessage,
+        defaultPasswordTitle: defaultPasswordTitle ?? this.defaultPasswordTitle,
+        defaultPasswordLabel: defaultPasswordLabel ?? this.defaultPasswordLabel,
+        defaultPasswordHint: defaultPasswordHint ?? this.defaultPasswordHint,
+        defaultPasswordValidatorMessage: defaultPasswordValidatorMessage ??
+            this.defaultPasswordValidatorMessage,
+        defaultPasswordToShortValidatorMessage:
+            defaultPasswordToShortValidatorMessage ??
+                this.defaultPasswordToShortValidatorMessage,
+      );
 }

lib/src/model/auth_action.dart

@@ -2,14 +2,19 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
-import 'package:flutter/material.dart';
+import "package:flutter/material.dart";
 
+/// An action that can be performed during authentication.
 class AuthAction {
+  /// Constructs an [AuthAction] object.
   AuthAction({
     required this.title,
     required this.onPress,
   });
 
+  /// The title of the action.
   final String title;
+
+  /// A callback function triggered when the action is pressed.
   final VoidCallback onPress;
 }

lib/src/model/auth_bool_field.dart

@@ -0,0 +1,78 @@
+// SPDX-FileCopyrightText: 2022 Iconica
+//
+// SPDX-License-Identifier: BSD-3-Clause
+
+import "package:flutter/material.dart";
+import "package:flutter_input_library/flutter_input_library.dart";
+import "package:flutter_registration/flutter_registration.dart";
+
+/// A field for capturing boolean values in a Flutter form.
+///
+/// Extends [AuthField].
+class AuthBoolField extends AuthField {
+  /// Constructs an [AuthBoolField] object.
+  ///
+  /// [name] specifies the name of the field.
+  ///
+  /// [widgetType] defines the type of boolean widget to use.
+  ///
+  /// [title] specifies the title of the field (optional).
+  ///
+  /// [validators] defines a list of validation functions for the field.
+  ///
+  /// [value] specifies the initial value of the field (default is false).
+  ///
+  /// [leftWidget] is a widget to be displayed on the
+  /// left side of the boolean widget.
+  ///
+  /// [rightWidget] is a widget to be displayed on the
+  /// right side of the boolean widget.
+  ///
+  /// [onChange] is a callback function triggered when
+  /// the value of the field changes.
+  AuthBoolField({
+    required super.name,
+    required this.widgetType,
+    super.title,
+    super.validators = const [],
+    super.value = false,
+    this.leftWidget,
+    this.rightWidget,
+    this.onChange,
+  });
+
+  /// A widget to be displayed on the left side of the boolean widget.
+  final Widget? leftWidget;
+
+  /// A widget to be displayed on the right side of the boolean widget.
+  final Widget? rightWidget;
+
+  /// The type of boolean widget to use.
+  final BoolWidgetType widgetType;
+
+  /// A callback function triggered when the value of the field changes.
+  final Function(String value)? onChange;
+
+  @override
+  Widget build(BuildContext context, Function onValueChanged) =>
+      FlutterFormInputBool(
+        widgetType: widgetType,
+        onChanged: (v) {
+          value = v;
+          onChange?.call(value);
+          // ignore: avoid_dynamic_calls
+          onValueChanged();
+        },
+        validator: (value) {
+          for (var validator in validators) {
+            var output = validator(value);
+            if (output != null) {
+              return output;
+            }
+          }
+          return null;
+        },
+        leftWidget: leftWidget,
+        rightWidget: rightWidget,
+      );
+}

lib/src/model/auth_drop_down.dart

@@ -0,0 +1,78 @@
+import "package:flutter/material.dart";
+import "package:flutter_registration/flutter_registration.dart";
+
+/// A field for capturing dropdown selections in a Flutter form.
+///
+/// Extends [AuthField].
+class AuthDropdownField extends AuthField {
+  /// Constructs an [AuthDropdownField] object.
+  AuthDropdownField({
+    required super.name,
+    required this.items,
+    required this.onChanged,
+    required super.value,
+    this.dropdownDecoration,
+    this.padding = const EdgeInsets.all(8.0),
+    this.textStyle,
+    this.icon = const Icon(Icons.keyboard_arrow_down),
+  }) {
+    selectedValue = value ?? items.first;
+  }
+
+  /// The list of items for the dropdown.
+  final List<String> items;
+
+  /// A callback function triggered when the dropdown value changes.
+  final Function(String?) onChanged;
+
+  /// The currently selected value in the dropdown.
+  String? selectedValue;
+
+  /// The decoration for the dropdown.
+  final InputDecoration? dropdownDecoration;
+
+  /// The padding around the dropdown.
+  final EdgeInsets padding;
+
+  /// The text style for the dropdown.
+  final TextStyle? textStyle;
+
+  /// The icon to be displayed with the dropdown.
+  final Icon icon;
+
+  @override
+  Widget build(BuildContext context, Function onValueChanged) => Padding(
+        padding: padding,
+        child: DropdownButtonFormField<String>(
+          icon: icon,
+          style: textStyle,
+          value: selectedValue,
+          decoration: dropdownDecoration,
+          items: items
+              .map(
+                (String value) => DropdownMenuItem<String>(
+                  value: value,
+                  child: Text(value),
+                ),
+              )
+              .toList(),
+          onChanged: (newValue) {
+            selectedValue = newValue;
+            onChanged(newValue);
+            // ignore: avoid_dynamic_calls
+            onValueChanged();
+          },
+          validator: (value) {
+            if (validators.isNotEmpty) {
+              for (var validator in validators) {
+                var output = validator(value);
+                if (output != null) {
+                  return output;
+                }
+              }
+            }
+            return null;
+          },
+        ),
+      );
+}

lib/src/model/auth_exception.dart

@@ -2,12 +2,14 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
+/// An exception thrown when an authentication error occurs.
 class AuthException implements Exception {
+  /// Constructs an [AuthException] object.
   AuthException(this.message);
+
+  /// The error message.
   final String message;
 
   @override
-  String toString() {
+  String toString() => message;
-    return message;
-  }
 }

lib/src/model/auth_field.dart

@@ -2,20 +2,53 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
-import 'package:flutter/material.dart';
+import "package:flutter/material.dart";
 
-abstract class AuthField {
+/// An abstract class representing a field in a Flutter form.
+///
+/// [T] represents the type of value stored in the field.
+abstract class AuthField<T> {
+  /// Constructs an [AuthField] object.
+  ///
+  /// [name] specifies the name of the field.
+  ///
+  /// [value] specifies the initial value of the field.
+  ///
+  /// [onValueChanged] is a callback function triggered when the
+  /// value of the field changes (optional).
+  ///
+  /// [title] specifies the title widget of the field (optional).
+  ///
+  /// [validators] defines a list of validation
+  /// functions for the field (optional).
   AuthField({
     required this.name,
+    required this.value,
+    this.onValueChanged,
     this.title,
     this.validators = const [],
-    this.value = '',
   });
 
+  /// The name of the field.
   final String name;
-  final Widget? title;
-  List<String? Function(String?)> validators;
-  String value;
 
-  Widget build();
+  /// The initial value of the field.
+  T value;
+
+  /// A callback function triggered when the value of the field changes.
+  final Function(T)? onValueChanged;
+
+  /// The title widget of the field.
+  final Widget? title;
+
+  /// A list of validation functions for the field.
+  List<String? Function(T?)> validators;
+
+  /// Builds the widget representing the field.
+  ///
+  /// [context] The build context.
+  ///
+  /// [onValueChanged] A function to be called when
+  /// the value of the field changes.
+  Widget build(BuildContext context, Function onValueChanged);
 }

lib/src/model/auth_pass_field.dart

@@ -0,0 +1,96 @@
+// SPDX-FileCopyrightText: 2024 Iconica
+//
+// SPDX-License-Identifier: BSD-3-Clause
+
+import "package:flutter/material.dart";
+import "package:flutter_input_library/flutter_input_library.dart";
+import "package:flutter_registration/flutter_registration.dart";
+
+/// A field for capturing password inputs in a Flutter form.
+///
+/// Extends [AuthField].
+class AuthPassField extends AuthField {
+  /// Constructs an [AuthPassField] object.
+  ///
+  /// [name] specifies the name of the field.
+  ///
+  /// [textEditingController] controller for the password input (optional).
+  ///
+  /// [title] specifies the title widget of the field (optional).
+  ///
+  /// [validators] defines a list of validation
+  /// functions for the field (optional).
+  ///
+  /// [value] specifies the initial value of the
+  /// field (default is an empty string).
+  ///
+  /// [textStyle] defines the text style for the password input.
+  ///
+  /// [onChange] is a callback function triggered when
+  /// the value of the field changes.
+  ///
+  /// [iconSize] specifies the size of the icon displayed
+  /// with the password input (optional).
+  ///
+  /// [textFieldDecoration] defines the decoration for the
+  /// password input field (optional).
+  ///
+  /// [padding] defines the padding around the password input
+  /// field (default is EdgeInsets.all(8.0)).
+  AuthPassField({
+    required super.name,
+    this.textEditingController,
+    super.title,
+    super.validators = const [],
+    super.value = "",
+    this.textStyle,
+    this.onChange,
+    this.iconSize,
+    this.textFieldDecoration,
+    this.padding = const EdgeInsets.all(8.0),
+  });
+
+  /// The text style for the password input.
+  final TextStyle? textStyle;
+
+  /// The size of the icon displayed with the password input.
+  final double? iconSize;
+
+  /// A callback function triggered when the value of the field changes.
+  final Function(String value)? onChange;
+
+  /// The decoration for the password input field.
+  final InputDecoration? textFieldDecoration;
+
+  /// The padding around the password input field.
+  final EdgeInsets padding;
+
+  /// The controller for the password input.
+  final TextEditingController? textEditingController;
+
+  @override
+  Widget build(BuildContext context, Function onValueChanged) => Padding(
+        padding: padding,
+        child: FlutterFormInputPassword(
+          style: textStyle,
+          iconSize: iconSize ?? 24.0,
+          decoration: textFieldDecoration,
+          onChanged: (v) {
+            value = v;
+            onChange?.call(value);
+            // ignore: avoid_dynamic_calls
+            onValueChanged();
+          },
+          validator: (value) {
+            for (var validator in validators) {
+              var output = validator(value);
+              if (output != null) {
+                return output;
+              }
+            }
+
+            return null;
+          },
+        ),
+      );
+}

lib/src/model/auth_step.dart

@@ -2,12 +2,15 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
-import 'package:flutter_registration/src/model/auth_field.dart';
+import "package:flutter_registration/src/model/auth_field.dart";
 
+/// A step in the authentication process.
 class AuthStep {
+  /// Constructs an [AuthStep] object.
   AuthStep({
     required this.fields,
   });
 
+  /// The fields in the step.
   List<AuthField> fields;
 }

lib/src/model/auth_text_field.dart

@@ -2,53 +2,95 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
-import 'package:flutter/material.dart';
+import "package:flutter/material.dart";
-import 'package:flutter_registration/flutter_registration.dart';
+import "package:flutter_registration/flutter_registration.dart";
 
+/// A field for capturing text inputs in a Flutter form.
+///
+/// Extends [AuthField].
 class AuthTextField extends AuthField {
+  /// Constructs an [AuthTextField] object.
+  ///
+  /// [name] specifies the name of the field.
+  ///
+  /// [textEditingController] controller for the text input (optional).
+  ///
+  /// [title] specifies the title widget of the field (optional).
+  ///
+  /// [validators] defines a list of validation
+  /// functions for the field (optional).
+  ///
+  /// [value] specifies the initial value of the
+  /// field (default is an empty string).
+  ///
+  /// [textStyle] defines the text style for the text input.
+  ///
+  /// [onChange] is a callback function triggered
+  /// when the value of the field changes.
+  ///
+  /// [textFieldDecoration] defines the decoration
+  /// for the text input field (optional).
+  ///
+  /// [padding] defines the padding around the text
+  /// input field (default is EdgeInsets.all(8.0)).
   AuthTextField({
     required super.name,
+    TextEditingController? textEditingController,
     super.title,
     super.validators = const [],
-    super.value = '',
+    super.value = "",
-    this.obscureText = false,
-    this.hintText,
-    this.label,
     this.textStyle,
     this.onChange,
+    this.textFieldDecoration,
+    this.padding = const EdgeInsets.all(8.0),
+    this.textInputType,
   }) {
-    _textEditingController = TextEditingController();
+    textController =
+        textEditingController ?? TextEditingController(text: value);
   }
 
-  late TextEditingController _textEditingController;
+  /// The controller for the text input.
-  final bool obscureText;
+  late TextEditingController textController;
-  final String? hintText;
+
-  final Widget? label;
+  /// The text style for the text input.
   final TextStyle? textStyle;
+
+  /// A callback function triggered when the value of the field changes.
   final Function(String value)? onChange;
 
-  @override
+  /// The decoration for the text input field.
-  Widget build() => TextFormField(
+  final InputDecoration? textFieldDecoration;
-        style: textStyle,
-        decoration: InputDecoration(
-          label: label,
-          hintText: hintText,
-        ),
-        controller: _textEditingController,
-        obscureText: obscureText,
-        onChanged: (v) {
-          value = v;
-          onChange?.call(value);
-        },
-        validator: (value) {
-          for (var validator in validators) {
-            var output = validator(value);
-            if (output != null) {
-              return output;
-            }
-          }
 
-          return null;
+  /// The padding around the text input field.
-        },
+  final EdgeInsets padding;
+
+  /// The type of text input.
+  final TextInputType? textInputType;
+
+  @override
+  Widget build(BuildContext context, Function onValueChanged) => Padding(
+        padding: padding,
+        child: TextFormField(
+          keyboardType: textInputType,
+          style: textStyle,
+          decoration: textFieldDecoration,
+          controller: textController,
+          onChanged: (v) {
+            value = v;
+            onChange?.call(value);
+            // ignore: avoid_dynamic_calls
+            onValueChanged();
+          },
+          validator: (value) {
+            for (var validator in validators) {
+              var output = validator(value);
+              if (output != null) {
+                return output;
+              }
+            }
+
+            return null;
+          },
+        ),
       );
 }

lib/src/registration_screen.dart

@@ -1,51 +1,77 @@
-// SPDX-FileCopyrightText: 2022 Iconica
+import "dart:collection";
-//
-// SPDX-License-Identifier: BSD-3-Clause
 
-import 'dart:collection';
+import "package:flutter/material.dart";
+import "package:flutter_registration/flutter_registration.dart";
+import "package:flutter_registration/src/auth_screen.dart";
 
-import 'package:flutter/material.dart';
+/// A screen for user registration.
-import 'package:flutter_registration/flutter_registration.dart';
+class RegistrationScreen extends StatefulWidget {
-import 'package:flutter_registration/src/auth_screen.dart';
+  /// Constructs a [RegistrationScreen] object.
-
+  ///
-class RegistrationScreen extends StatelessWidget {
+  /// [registrationOptions] specifies the registration options.
   const RegistrationScreen({
     required this.registrationOptions,
     super.key,
   });
 
+  /// The registration options.
   final RegistrationOptions registrationOptions;
 
   @override
-  Widget build(BuildContext context) {
+  RegistrationScreenState createState() => RegistrationScreenState();
-    var translations = registrationOptions.registrationTranslations;
+}
 
-    void register({
+/// The state for [RegistrationScreen].
-      required HashMap<String, String> values,
+class RegistrationScreenState extends State<RegistrationScreen> {
-      required VoidCallback onError,
+  /// Registers the user.
-    }) =>
+  Future<void> _register({
-        registrationOptions.registrationRepository.register(values).then(
+    required HashMap<String, dynamic> values,
-          (response) {
+    required void Function(int? pageToReturn) onError,
-            if (response) {
+  }) async {
-              registrationOptions.afterRegistration();
+    try {
-            }
+      await widget.registrationOptions.beforeRegistration?.call();
-          },
+
-        ).catchError((_) {
+      var registered = await widget.registrationOptions.registrationRepository!
-          onError();
+          .register(values);
-        });
+
+      if (registered == null) {
+        widget.registrationOptions.afterRegistration();
+      } else {
+        var pageToReturn = widget.registrationOptions.onError?.call(registered);
+
+        onError(pageToReturn);
+      }
+    } on Exception catch (_) {
+      onError(null);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    var translations = widget.registrationOptions.registrationTranslations;
 
     return AuthScreen(
-      steps: registrationOptions.registrationSteps,
+      steps: widget.registrationOptions.steps,
-      customAppBar: registrationOptions.customAppbarBuilder?.call(
+      customAppBar: widget.registrationOptions.customAppbarBuilder?.call(
         translations.title,
       ),
-      onFinish: register,
+      onFinish: _register,
-      title: translations.title,
+      appBarTitle: translations.title,
       submitBtnTitle: translations.registerBtn,
       nextBtnTitle: translations.nextStepBtn,
       previousBtnTitle: translations.previousStepBtn,
-      nextButtonBuilder: registrationOptions.nextButtonBuilder,
+      nextButtonBuilder: widget.registrationOptions.nextButtonBuilder,
-      previousButtonBuilder: registrationOptions.previousButtonBuilder,
+      previousButtonBuilder: widget.registrationOptions.previousButtonBuilder,
+      buttonMainAxisAlignment:
+          widget.registrationOptions.buttonMainAxisAlignment,
+      customBackgroundColor: widget.registrationOptions.backgroundColor,
+      titleWidget: widget.registrationOptions.titleWidget,
+      loginButton: widget.registrationOptions.loginButton,
+      titleFlex: widget.registrationOptions.titleFlex,
+      formFlex: widget.registrationOptions.formFlex,
+      beforeTitleFlex: widget.registrationOptions.beforeTitleFlex,
+      afterTitleFlex: widget.registrationOptions.afterTitleFlex,
+      maxFormWidth: widget.registrationOptions.maxFormWidth,
     );
   }
 }

lib/src/service/registration_repository.dart

@@ -2,8 +2,10 @@
 //
 // SPDX-License-Identifier: BSD-3-Clause
 
-import 'dart:collection';
+import "dart:collection";
 
+/// A mixin for a registration repository.
 mixin RegistrationRepository {
-  Future<bool> register(HashMap values);
+  /// Registers a user with the given values.
+  Future<String?> register(HashMap values);
 }

pubspec.yaml

@@ -4,23 +4,31 @@
 
 name: flutter_registration
 description: A Flutter Registration package
-version: 0.2.0
+version: 3.0.0
 repository: https://github.com/Iconica-Development/flutter_registration
 
+publish_to: https://forgejo.internal.iconica.nl/api/packages/internal/pub
+
 environment:
-  sdk: '>=2.18.0 <3.0.0'
+  sdk: ">=3.0.0 <4.0.0"
   flutter: ">=1.17.0"
 
 dependencies:
+  flutter_input_library:
+    hosted: https://forgejo.internal.iconica.nl/api/packages/internal/pub
+    version: ^3.6.0
+
   flutter:
     sdk: flutter
   flutter_localizations:
     sdk: flutter
-  flutter_hooks: any
 
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^2.0.0
+  flutter_iconica_analysis:
+    git:
+      url: https://github.com/Iconica-Development/flutter_iconica_analysis
+      ref: 7.0.0
 
 flutter:

test/flutter_email_password_login_test.dart

@@ -3,10 +3,10 @@
 // SPDX-License-Identifier: BSD-3-Clause
 // SPDX-License-Identifier: GPL-3.0-or-later
 
-import 'package:flutter_test/flutter_test.dart';
+import "package:flutter_test/flutter_test.dart";
 
 void main() {
-  test('test', () {
+  test("test", () {
     expect(true, true);
   });
 }