1. Reactive State Manager (Rx & Obx)

Reactive programming with getxtra completely removes streams, StreamControllers, and code generators.

Simply append .obs to make any variable observable:

// ● controller.dart
var name = 'Jonatas Borges'.obs;
var count = 0.obs;
var userList = <User>[].obs;

In the UI, wrap your widget in Obx. It will rebuild only when the specific observed values change:

// ● view.dart
Obx(() => Text("Hello, ${controller.name}"));

2. Simple State Manager (GetBuilder)

For ultra-lightweight, high-performance UI updates with zero stream overhead and negligible memory footprint, use GetBuilder.

// ● controller.dart
class Controller extends GetxController {
  int counter = 0;
  void increment() {
    counter++;
    update(); // Notifies and rebuilds listening GetBuilder widgets
  }
}

// ● view.dart
GetBuilder<Controller>(
  init: Controller(), // Instantiates the controller
  builder: (value) => Text('Count: ${value.counter}'),
)

getxtra completely decouples navigation from the widget tree. Open snackbars, pop screens, and navigate to routes without ever passing a BuildContext.

1. Initialization

Simply swap your core MaterialApp widget for GetMaterialApp:

// ● main.dart
GetMaterialApp(
  home: MyHome(),
)

2. Navigation Control APIs

• Navigate to a new page widget:

  Get.to(NextScreen());
  

• Navigate via Named Route:

  Get.toNamed('/details');
  

• Close dialogs, snackbars, bottom sheets, or pop the route:

  Get.back();
  

• Navigate to a new screen and remove the immediate previous route (e.g., Splash to Login):

  Get.off(NextScreen());
  

• Navigate to a new screen and clear the entire navigation history stack (e.g., Login to Dashboard):

  Get.offAll(NextScreen());
  

3. Advanced Navigation

// Navigate and clean up history until a specific condition matches
Get.offUntil(DashboardScreen(), (route) => route.isFirst);

// Named routing equivalent
Get.offNamedUntil('/dashboard', (route) => route.isFirst);

// Manually remove a specific route from stack
Get.removeRoute(targetRoute);

A highly optimized service locator is built directly into getxtra. Skip heavy architectures and retrieve logic files instantly.

1. Register a Dependency

Save a class instance inside the global memory space:

Controller controller = Get.put(Controller());

2. Retrieve the Dependency

Recover the registered instance from anywhere in your codebase:

Controller controller = Get.find();

3. Automated Lifecycle & Cleanup

getxtra is designed to be highly memory-efficient. When a screen is popped, its associated controller is automatically garbage-collected and disposed.

• Keep dependency persistent: Pass permanent: true to prevent automatic teardown:

  Get.put(Controller(), permanent: true);
  

• Lazy Loading: Load the class into memory only when it is actually called by Get.find():

  Get.lazyPut<Service>(() => ServiceImpl());
  

Manage translations with ease using lightweight key-value dictionary maps.

1. Configure Custom Translations

Extend the Translations class to setup multiple locales:

// ● translations.dart
import 'package:getxtra/get.dart';

class Messages extends Translations {
  @override
  Map<String, Map<String, String>> get keys => {
        'en_US': {
          'hello': 'Hello World',
          'logged_in': 'Logged in as @name',
        },
        'de_DE': {
          'hello': 'Hallo Welt',
          'logged_in': 'Eingeloggt als @name',
        }
      };
}

2. Output Translations in UI

• Basic Translation:

  Text('hello'.tr);
  

• With Parameters:

  Text('logged_in'.trParams({'name': 'Gaurav'}));
  

• With Plurals:

  Text('singularKey'.trPlural('pluralKey', itemCount, args));
  

3. Localization Settings

Configure GetMaterialApp with your translation maps:

GetMaterialApp(
  translations: Messages(),
  locale: Locale('en', 'US'),
  fallbackLocale: Locale('en', 'UK'),
)

Change active locales dynamically:

var locale = Locale('de', 'DE');
Get.updateLocale(locale); // All UI widgets using .tr rebuild instantly!

Update dark/light themes instantly without boilerplate ThemeProviders or duplicate keys.

1. Dynamic Theme Controls

• Switch to a custom theme:

  Get.changeTheme(ThemeData.light());
  

• Dark/Light Mode toggling:

  Get.changeTheme(Get.isDarkMode ? ThemeData.light() : ThemeData.dark());
  

2. Rich Layout & Dimension Context Extensions

getxtra provides robust, high-performance extensions to read screen properties quickly:

// Immutable dimensions
Get.height // Double screen height
Get.width  // Double screen width

// Context-aware responsive mappings
context.responsiveValue<T>(
  watch: watchVal,
  mobile: mobileVal,
  tablet: tabletVal,
  desktop: desktopVal,
)

// Structural platform checks
context.isPhone()
context.isTablet()
context.isLandscape()

An ultra-light REST client and WebSocket architecture that bypasses heavy network package dependencies.

1. Standard API Setup

// ● api_provider.dart
class UserProvider extends GetConnect {
  // GET request
  Future<Response> getUser(int id) => get('http://api.com/users/$id');

  // POST request
  Future<Response> postUser(Map data) => post('http://api.com/users', body: data);

  // File Upload
  Future<Response> uploadAvatar(List<int> image) {
    final form = FormData({
      'file': MultipartFile(image, filename: 'avatar.png'),
    });
    return post('http://api.com/users/upload', form);
  }
}

2. High-End Customization (Interceptors & Retries)

// ● api_provider.dart
class AdvancedProvider extends GetConnect {
  @override
  void onInit() {
    httpClient.baseUrl = 'https://api.com';
    httpClient.defaultDecoder = UserModel.fromJson;

    // Intercept outbound requests
    httpClient.addRequestModifier((request) {
      request.headers['Authorization'] = 'Bearer TOKEN';
      return request;
    });

    // Intercept incoming responses
    httpClient.addResponseModifier<UserModel>((request, response) {
      // Modify payload before UI delivery
      return response;
    });

    // Authenticator & Automatic recovery
    httpClient.addAuthenticator((request) async {
      final tokenRes = await get("http://api.com/token");
      request.headers['Authorization'] = "${tokenRes.body['token']}";
      return request;
    });
    httpClient.maxAuthRetries = 3;
  }
}

GetPage supports full middleware pipelines to intercept and validate route requests before screens build.

// ● routing.dart
GetPage(
  name: '/profile',
  page: () => ProfileView(),
  middlewares: [
    AuthMiddleware(priority: 1),
    AnalyticsMiddleware(priority: 2),
  ],
)

1. Build Custom Middleware

// ● auth_middleware.dart
class AuthMiddleware extends GetMiddleware {
  @override
  int priority = 1;

  @override
  RouteSettings redirect(String route) {
    final authService = Get.find<AuthService>();
    return authService.isAuthenticated.value 
      ? null 
      : RouteSettings(name: '/login');
  }
}

2. Middleware Hooks

• onPageCalled: Intercept the Page parameters before creation.
• onBindingsStart: Manipulate bindings list right before loading.
• onPageBuildStart: Execute code after loading bindings and before build.
• onPageBuilt: Capture the returned built page widget.
• onPageDispose: Execute tasks immediately upon page disposal.

1. GetView

An elegant, stateless wrapper containing a direct getter for your registered controller, cutting down boilerplate lookup code:

// ● view.dart
class ProfileView extends GetView<ProfileController> {
  @override
  Widget build(BuildContext context) {
    // Access 'controller' instantly without lookup or declaration!
    return Text(controller.username);
  }
}

2. GetResponsiveView

Rapidly build robust interfaces tailored for mobile, tablet, and desktop viewports:

// ● view.dart
class HomeView extends GetResponsiveView<HomeController> {
  @override
  Widget? builder() {
    if (screen.isPhone) return PhoneLayout();
    if (screen.isTablet) return TabletLayout();
    return DesktopLayout();
  }
}

3. GetxService

A persistent, long-running service wrapper that cannot be auto-removed from memory, making it perfect for databases and cache engines:

// ● db_service.dart
class DatabaseService extends GetxService {
  Future<DatabaseService> init() async {
    // Perform SQLite or Hive setup
    return this;
  }
}

Easily test controllers, network responses, and routing transitions without rendering widget trees.

// ● test/controller_test.dart
class Controller extends GetxController {
  final name = 'guest'.obs;
  void updateName(String newName) => name.value = newName;
}

void main() {
  test('Test reactive controller state', () {
    final controller = Controller();
    expect(controller.name.value, 'guest');

    // Register controller to trigger onInit hooks
    Get.put(controller); 
    controller.updateName('Gaurav');
    expect(controller.name.value, 'Gaurav');

    // Teardown
    Get.delete<Controller>();
  });
}