FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':app:processDebugResources'.

# Clean project
cd android
./gradlew clean
cd ..
flutter clean

# Rebuild
flutter pub get
flutter build apk --flavor development -t lib/main_development.dart

[!] CocoaPods could not find compatible versions for pod "Firebase/Core"

cd ios
rm -rf Pods Podfile.lock
pod cache clean --all
pod deintegrate
pod install --repo-update
cd ..

Error: Could not resolve the package 'native_sound_plugin'

# Set environment variable
export NATIVE_SOUND_PLUGIN_PATH=/absolute/path/to/native_sound_plugin/ios

# Or update pubspec.yaml
# dependencies:
#   native_sound_plugin:
#     path: /absolute/path/to/native_sound_plugin

cd ios
pod install
cd ..

[WARNING] build_runner:build_runner on lib/core/product/product_api.dart:
Conflicting outputs were detected

# Force regenerate
flutter pub run build_runner build --delete-conflicting-outputs

# Or use watch mode
flutter pub run build_runner watch --delete-conflicting-outputs

Error: Part file doesn't exist: 'product_api.g.dart'

# Ensure part directive exists
# In product_api.dart:
# part 'product_api.g.dart';

# Run code generation
flutter pub run build_runner build --delete-conflicting-outputs

DioException [connection error]: Connection refused

// Check API base URL
print('API_BASE_URL: $API_BASE_URL');

// Test with curl
curl -X GET https://dev-api.mstore.com/api/v1/products

// Check network connectivity
final connectivity = await Connectivity().checkConnectivity();
print('Connectivity: $connectivity');

Error: Refresh token invalid or expired

// Clear tokens and re-login
await AuthService().logout();
await AuthService().clearTokens();

// Navigate to login
context.go('/login');

MQTT connection failed: Connection refused

// Check MQTT configuration
print('MQTT_BROKER: $MQTT_BROKER');
print('MQTT_PORT: $MQTT_PORT');
print('MQTT_CLIENT_ID: $MQTT_CLIENT_ID');

// Test MQTT connection
final client = MqttServerClient(MQTT_BROKER, MQTT_CLIENT_ID);
client.port = int.parse(MQTT_PORT);
client.logging(on: true);
await client.connect(MQTT_USERNAME, MQTT_PASSWORD);

IsarError: Isar instance with name 'default' is already open

// Close existing instance first
if (Isar.instanceNames.contains('default')) {
  final isar = Isar.getInstance('default');
  await isar?.close();
}

// Then open new instance
final isar = await Isar.open([...schemas]);

IsarError: Schema version mismatch

# Regenerate Isar schemas
flutter pub run build_runner build --delete-conflicting-outputs

# Or delete database and recreate
# Database location:
# iOS: ~/Library/Developer/CoreSimulator/Devices/.../Documents/
# Android: /data/data/com.mstore.mobile/files/

// Check local data
final products = await isar.productLocals.where().findAll();
print('Local products: ${products.length}');

// Check API data
final result = await productRepository.getProducts();
result.fold(
  (failure) => print('API Error: ${failure.message}'),
  (products) => print('API products: ${products.length}'),
);

// Check sync service
final syncService = getIt<OfflineSyncService>();
final pendingSync = await syncService.getPendingItems();
print('Pending sync: ${pendingSync.length}');

// Add logging to BLoC
@override
void onChange(Change<ProductState> change) {
  super.onChange(change);
  print('State changed: ${change.currentState} -> ${change.nextState}');
}

// Check BlocBuilder buildWhen
BlocBuilder<ProductBloc, ProductState>(
  buildWhen: (previous, current) {
    print('buildWhen: $previous != $current');
    return previous != current;
  },
  builder: (context, state) => ...,
)

A RenderFlex overflowed by 123 pixels on the right.

// ✅ Use Expanded/Flexible
Row(
  children: [
    Expanded(child: Text('Long text...')),
    Icon(Icons.arrow_forward),
  ],
)

// ✅ Use ListView for scrollable content
ListView(
  children: [...],
)

// ✅ Wrap with SingleChildScrollView
SingleChildScrollView(
  child: Column(children: [...]),
)

// Enable performance overlay
void main() {
  runApp(
    MaterialApp(
      showPerformanceOverlay: true,
      home: MyApp(),
    ),
  );
}

// Use Flutter DevTools
// flutter pub global activate devtools
// flutter pub global run devtools

Error: Invalid credentials

// Check request payload
AppLog.i('auth', 'login_attempt', meta: {
  'email': email,
  'endpoint': '$API_BASE_URL/api/v1/auth/login',
});

// Check response
final response = await authApi.login(email, password);
print('Response: ${response.data}');

HTTP 401: Unauthorized

// RefreshTokenInterceptor should handle this automatically
// If not working, check:

// 1. Verify interceptor is registered
dio.interceptors.add(RefreshTokenInterceptor(dio: dio));

// 2. Check refresh token exists
final refreshToken = await AuthService().getRefreshToken();
print('Refresh token: ${refreshToken != null}');

// 3. Manual refresh
await AuthService().silentRefreshIfNeeded();

Error: No paired Bluetooth devices found

// 1. Check Bluetooth permissions
// iOS: Info.plist
// <key>NSBluetoothAlwaysUsageDescription</key>
// <string>Need Bluetooth for printer</string>

// Android: AndroidManifest.xml
// <uses-permission android:name="android.permission.BLUETOOTH"/>
// <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
// <uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>

// 2. Request permissions
await Permission.bluetooth.request();
await Permission.bluetoothConnect.request();

// 3. Scan for devices
final printerService = getIt<PrinterService>();
final devices = await printerService.scanDevices();
print('Found devices: ${devices.length}');

// Check printer connection
final isConnected = await printerService.isConnected();
print('Printer connected: $isConnected');

// Test print
await printerService.printTest();

// Check receipt data
print('Receipt data: ${receipt.toString()}');

cd ios
pod deintegrate
pod install
cd ..
flutter clean
flutter run

Error: The plugin requires a minimum Android SDK version of 21

// android/app/build.gradle
android {
    defaultConfig {
        minSdkVersion 21  // Update this
        targetSdkVersion 34
    }
}

// android/app/build.gradle
android {
    defaultConfig {
        multiDexEnabled true
    }
}

dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
}

# Activate DevTools
flutter pub global activate devtools

# Run DevTools
flutter pub global run devtools

# Or use from VS Code
# View → Command Palette → "Dart: Open DevTools"

// Enable verbose logging
AppLog.setLevel(LogLevel.verbose);

// Log BLoC events
Bloc.observer = const AppBlocObserver();

// Log HTTP requests
dio.interceptors.add(LoggingInterceptor());

// Export logs
final logs = await AppLog.exportLogs();
await Share.shareFiles([logs]);

// Use Alice for HTTP inspection
final alice = Alice(showNotification: true);
dio.interceptors.add(alice.getDioInterceptor());

// Or use Charles Proxy
// Configure proxy in device settings

## Environment
- Flutter version: 3.8.0
- Dart version: 3.8.0
- Platform: iOS 17.0 / Android 14
- Device: iPhone 15 Pro / Pixel 8

## Description
Clear description of the issue

## Steps to Reproduce
1. Open app
2. Navigate to Cashier
3. Add product to cart
4. Crash occurs

## Expected Behavior
Cart should update

## Actual Behavior
App crashes with error: ...

## Logs

## Screenshots
[Attach screenshots if applicable]

## Additional Context
Any other relevant information

# Flutter doctor
flutter doctor -v

# Clean and rebuild
flutter clean && flutter pub get && flutter run

# Analyze code
flutter analyze

# Run tests
flutter test

# Check dependencies
flutter pub outdated

# Update dependencies
flutter pub upgrade

# Generate code
flutter pub run build_runner build --delete-conflicting-outputs

# Profile performance
flutter run --profile

# Build with verbose
flutter build apk --verbose