feat: add UI customization options for card form

.github/workflows/flutter_test.yml

@@ -10,50 +10,118 @@ jobs:
   integration-test:
     name: integration-test
     runs-on: ubuntu-latest
+    env:
+      API_LEVEL: 30
+      TARGET: default
+      ARCH: x86_64
     steps:
+      - name: Free disk space
+        uses: jlumbroso/free-disk-space@main
+        with:
+          tool-cache: false
+          android: false
+          dotnet: true
+          haskell: true
+          large-packages: true
+          docker-images: true
+          swap-storage: true
+
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v6
+
+      - name: Run Mockoon CLI
+        uses: mockoon/cli-action@v3
+        with:
+          data-file: 'https://raw.githubusercontent.com/conekta/openapi/main/mocks/conekta_api.json'
+          port: 3000
 
       - name: Set up Flutter
         uses: subosito/flutter-action@v2
         with:
           flutter-version: '3.x'
           channel: 'stable'
           cache: true
+
+      - name: Cache Gradle and pub
+        uses: actions/cache@v5
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+            ~/.pub-cache
+            android/.gradle
+          key: gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties', 'pubspec.lock') }}
+          restore-keys: |
+            gradle-${{ runner.os }}-
+
       - name: Get Flutter dependencies
         run: flutter pub get
 
-      - name: Accept Android licenses
-        run: yes | flutter doctor --android-licenses
-
       - name: Enable KVM
         run: |
           echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
           sudo udevadm control --reload-rules
           sudo udevadm trigger --name-match=kvm
-      - name: Set up Android SDK
+
+      - name: AVD cache
+        uses: actions/cache@v5
+        id: avd-cache
+        with:
+          path: |
+            ~/.android/avd/*
+            ~/.android/adb*
+          key: avd-v2-${{ env.API_LEVEL }}-${{ env.TARGET }}-${{ env.ARCH }}
+
+      - name: Create AVD snapshot
+        if: steps.avd-cache.outputs.cache-hit != 'true'
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: ${{ env.API_LEVEL }}
+          target: ${{ env.TARGET }}
+          arch: ${{ env.ARCH }}
+          cores: 4
+          ram-size: 4096M
+          heap-size: 1024M
+          disable-animations: false
+          force-avd-creation: false
+          emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
+          script: echo "Generated AVD snapshot for caching."
+
+      - name: Run integration tests on Android emulator
         uses: reactivecircus/android-emulator-runner@v2
         with:
-          api-level: 31
+          api-level: ${{ env.API_LEVEL }}
+          target: ${{ env.TARGET }}
+          arch: ${{ env.ARCH }}
+          cores: 4
+          ram-size: 4096M
           heap-size: 1024M
           disable-animations: true
-          cores: 8
-          ram-size: 12288M
-          target: google_apis
-          arch: x86_64
+          force-avd-creation: false
+          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
           script: flutter test integration_test/
 
   test:
-    name: Run Flutter Tests
-    runs-on: ubuntu-latest
+    name: Run Flutter Tests (Flutter ${{ matrix.flutter-version }})
+    runs-on: aws-runner-set
+    strategy:
+      fail-fast: false
+      matrix:
+        flutter-version: ['3.19.x', '3.24.x', '3.29.x', '3.32.x', '3.x']
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v6
+
+      - name: Install xz-utils
+        run: |
+          if ! command -v xz >/dev/null 2>&1; then
+            sudo apt-get update && sudo apt-get install -y xz-utils
+          fi
 
       - name: Set up Flutter
         uses: subosito/flutter-action@v2
         with:
-          flutter-version: '3.x'
+          flutter-version: ${{ matrix.flutter-version }}
           channel: 'stable'
           cache: true
 

CHANGELOG.md

@@ -1,4 +1,13 @@
 # Changelog
+
+## [1.0.1] - 2026-04-17
+### Added
+- `CardFormConfig` class to group optional UI flags passed to `CardForm` via the `config` parameter.
+- `CardFormConfig.hideLogo` (default `false`) to show/hide the "Paga segura con Conekta" section.
+- `CardFormConfig.submitButtonText` (default `null`) to override the submit button label; falls back to the localized value when `null`.
+- Widget tests for `CardForm` config flags and `CardFormConfig` defaults.
+- Example usages in `example/lib/main.dart`.
+
 ## [1.0.0] - 2025-09-30
 - Final release
 

README.md

@@ -2,7 +2,7 @@
 
 A customizable Flutter widget for securely collecting credit card information. This library provides a user-friendly form with built-in validation and localization support, making it easy to integrate into your Flutter applications for payment processing.
 
-**Current Version:** 1.0.0
+**Current Version:** 1.0.1
 
 ## Features
 
@@ -16,7 +16,7 @@ A customizable Flutter widget for securely collecting credit card information. T
 
 ## Minimum Requirements
 
-*   **Dart SDK:** Version 2.17.0 or higher
+*   **Dart SDK:** Version 3.3.0 or higher (Flutter 3.19.0+)
 
 ## Installation
 

android/app/src/debug/AndroidManifest.xml

@@ -4,4 +4,5 @@
          to allow setting breakpoints, to provide hot reload, etc.
     -->
     <uses-permission android:name="android.permission.INTERNET"/>
+    <application android:usesCleartextTraffic="true" tools:replace="android:usesCleartextTraffic" xmlns:tools="http://schemas.android.com/tools" />
 </manifest>

example/lib/main.dart

@@ -55,8 +55,34 @@ class CreditCardFormScreen extends StatelessWidget {
           onSubmitted: _onSubmitted,
           paymentService: paymentService,
           locale: const Locale('es'),
+          config: const CardFormConfig(
+            hideLogo: false,
+            submitButtonText: 'Pagar ahora',
+          ),
         ),
       ),
     );
   }
 }
+
+/// Example: hide the "Paga segura con Conekta" badge and keep the localized
+/// submit label ("Continuar"/"Continue") by leaving [submitButtonText] as null.
+///
+/// ```dart
+/// CardForm(
+///   paymentService: paymentService,
+///   onSubmitted: _onSubmitted,
+///   config: const CardFormConfig(hideLogo: true),
+/// )
+/// ```
+///
+/// Example: English locale with a custom submit label.
+///
+/// ```dart
+/// CardForm(
+///   paymentService: paymentService,
+///   locale: const Locale('en'),
+///   onSubmitted: _onSubmitted,
+///   config: const CardFormConfig(submitButtonText: 'Pay now'),
+/// )
+/// ```

integration_test/card_form_test.dart

@@ -1,3 +1,5 @@
+import 'dart:io';
+
 import 'package:conekta_component/card_input_flutter.dart';
 import 'package:conekta_component/l10n/app_localizations.dart';
 import 'package:conekta_component/src/fields/card_cvv_field.dart';
@@ -9,25 +11,29 @@ import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:integration_test/integration_test.dart';
 
-import 'mocks/mock_payment_service.dart';
-
 void main() {
   IntegrationTestWidgetsFlutterBinding.ensureInitialized();
 
-  testWidgets('CardForm submits and returns success', (tester) async {
+  // Android emulator reaches the host machine via 10.0.2.2.
+  final mockoonHost =
+      Platform.isAndroid ? 'http://10.0.2.2:3000' : 'http://localhost:3000';
+
+  testWidgets('CardForm submits against Mockoon and returns success',
+      (tester) async {
     bool submitted = false;
 
     await tester.pumpWidget(
       MaterialApp(
-        localizationsDelegates: [
+        localizationsDelegates: const [
           AppLocalizations.delegate,
           GlobalMaterialLocalizations.delegate,
           GlobalWidgetsLocalizations.delegate,
           GlobalCupertinoLocalizations.delegate,
         ],
         home: Scaffold(
           body: CardForm(
-            paymentService: MockPaymentService(apiKey: "key_xxx"),
+            paymentService:
+                PaymentService(apiKey: 'key_xxx', host: mockoonHost),
             onSubmitted: (result) {
               submitted = result is Success<Map<String, dynamic>>;
             },
@@ -38,11 +44,11 @@ void main() {
 
     await tester.enterText(find.byType(CardNameField), 'Juan Pérez');
     await tester.enterText(find.byType(CardNumberField), '4242424242424242');
-    await tester.enterText(find.byType(CardExpiryFields), '12/25');
+    await tester.enterText(find.byType(CardExpiryFields), '12/30');
     await tester.enterText(find.byType(CardCVVField), '123');
 
     await tester.tap(find.byType(ElevatedButton));
-    await tester.pumpAndSettle();
+    await tester.pumpAndSettle(const Duration(seconds: 30));
 
     expect(submitted, isTrue);
   });

l10n.yaml

@@ -1,3 +1,4 @@
 arb-dir: lib/l10n
 template-arb-file: app_en.arb
 output-localization-file: app_localizations.dart
+output-dir: lib/l10n

lib/card_input_flutter.dart

@@ -1,6 +1,5 @@
-library credit_card_input_flutter;
-
 export 'src/card_form.dart';
 export 'src/services/payment_service.dart';
 export 'src/services/result.dart';
 export 'src/models/card_model.dart';
+export 'src/models/card_form_config.dart';

lib/src/card_form.dart

@@ -7,6 +7,7 @@ import 'fields/card_cvv_field.dart';
 import 'fields/card_expiry_fields.dart';
 import 'fields/card_name_field.dart';
 import 'fields/card_number_field.dart';
+import 'models/card_form_config.dart';
 import 'models/card_model.dart';
 import 'services/payment_service.dart';
 import 'utils/dark_theme.dart';
@@ -19,12 +20,14 @@ class CardForm extends StatefulWidget {
   final PaymentService paymentService;
   final Locale locale;
   final ThemeData? themeData;
+  final CardFormConfig config;
   const CardForm(
       {super.key,
       this.onSubmitted,
       required this.paymentService,
       this.locale = const Locale('es'),
-      this.themeData});
+      this.themeData,
+      this.config = const CardFormConfig()});
 
   @override
   State<CardForm> createState() => _CardFormState();
@@ -37,13 +40,15 @@ class _CardFormState extends State<CardForm> {
   final cardNumberController = TextEditingController();
   final nameController = TextEditingController();
   final cvvController = TextEditingController();
+  final nameFocusNode = FocusNode();
   bool _isLoading = false;
   @override
   void dispose() {
     cardNumberController.dispose();
     nameController.dispose();
     expiryDateController.dispose();
     cvvController.dispose();
+    nameFocusNode.dispose();
     super.dispose();
   }
 
@@ -68,6 +73,7 @@ class _CardFormState extends State<CardForm> {
         final result = await widget.paymentService
             .sendPayment(card, widget.locale.languageCode);
         cleanFields();
+        nameFocusNode.requestFocus();
         widget.onSubmitted?.call(Success(result));
       } on Exception catch (e) {
         widget.onSubmitted?.call(Failure(e));
@@ -79,7 +85,7 @@ class _CardFormState extends State<CardForm> {
     }
   }
 
-  cleanFields() {
+  void cleanFields() {
     cardNumberController.clear();
     nameController.clear();
     expiryDateController.clear();
@@ -115,7 +121,8 @@ class _CardFormState extends State<CardForm> {
                     child: Column(
                       crossAxisAlignment: CrossAxisAlignment.start,
                       children: [
-                        const SecurePaymentSection(),
+                        if (!widget.config.hideLogo)
+                          const SecurePaymentSection(),
                         Text(
                             AppLocalizations.of(localizedContext)!
                                 .cardNameLabel,
@@ -124,6 +131,7 @@ class _CardFormState extends State<CardForm> {
                         const SizedBox(height: 8),
                         CardNameField(
                           controller: nameController,
+                          focusNode: nameFocusNode,
                           decoration: InputDecoration(
                               hintText: AppLocalizations.of(localizedContext)!
                                   .cardNameHint),
@@ -258,8 +266,9 @@ class _CardFormState extends State<CardForm> {
                                             .colorScheme
                                             .onPrimary))
                                 : Text(
-                                    AppLocalizations.of(localizedContext)!
-                                        .submitButton,
+                                    widget.config.submitButtonText ??
+                                        AppLocalizations.of(localizedContext)!
+                                            .submitButton,
                                     style: TextStyle(
                                         fontSize: 16,
                                         color: Theme.of(themedContext)

lib/src/fields/card_cvv_field.dart

@@ -25,7 +25,7 @@ class CardCVVField extends StatelessWidget {
     return TextFormField(
       controller: controller,
       decoration: decoration ??
-          InputDecoration(
+          const InputDecoration(
             labelText: 'CVV',
             isDense: true,
           ).applyDefaults(Theme.of(context).inputDecorationTheme),