Flutter Hot Reload Not Working Fix

In this tutorial, you'll learn about Flutter Hot Reload Not Working Fix. We cover key concepts, practical examples, and best practices.

The Problem

Hot reload in Flutter is not working. Pressing r in the terminal or clicking the hot reload button does nothing, or the UI does not update after changes. You have to stop and restart the app every time.

Quick Fix

Step 1: Ensure you are in debug mode

flutter run

Expected: Hot reload only works in debug mode.

Step 2: Use the correct key

In terminal, press r (hot reload) or R (hot restart). In VS Code, use Ctrl+F5.

Step 3: Save all files before reload

Unsaved files are not included in hot reload. Save all modified files first (Ctrl+S on each).

Step 4: Check for state initialization in initState

class MyWidget extends StatefulWidget {
  @override
  State<MyWidget> createState() => _MyWidgetState();
}

class _MyWidgetState extends State<MyWidget> {
  late int counter;

  @override
  void initState() {
    super.initState();
    counter = 0;
  }

  @override
  Widget build(BuildContext context) {
    return Text('Count: $counter');
  }
}

Expected: Hot reload does not re-run initState. Restart the app to reset state.

Step 5: Check for compilation errors

flutter analyze

Prevention

• Save files before hot reloading.
• Use hot restart (R) if state does not update.
• Keep state in ChangeNotifiers or Bloc for hot reload compatibility.

Common Mistakes with hot reload

1. Using foldl instead of foldl' causing stack overflow on large lists
2. Forgetting deriving (Show, Eq) on custom data types needed for debugging
3. Placing the wildcard pattern first in case expressions, making all subsequent patterns unreachable

These mistakes appear frequently in real-world FLUTTER code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ