page_state_builder 0.0.3

A Flutter package that helps manage loading, success, and error states in your UI with customizable builders.

📦 page_state_builder

A simple and customizable Flutter widget to manage page states like loading, success, and error without boilerplate. Designed for clean and maintainable UI in apps where content is dynamically loaded.

---

✨ Features

• ✅ Show loading, error, or success states using one widget
• 🎨 Fully customizable widgets for loading and error states
• ♻️ Supports retry callbacks for error state
• 🚀 Built with simplicity and clean UI in mind
• ⚙️ Works well with state management libraries like GetX, Riverpod, Provider, etc.

---

📸 Preview

Loading State	Error State	Success State

---

🚀 Installation

Add this to your pubspec.yaml:

dependencies:
  page_state_builder: ^1.0.0

Then run:

flutter pub get

---

🛠️ Usage

PageStateBuilder(
  state: PageState.loading, // or PageState.success / PageState.error
  errorMessage: 'Something went wrong!',
  onRetry: () => loadData(),
  successBuilder: (_) => Text("Content loaded successfully!"),
);

💡 With state management (e.g., GetX):

Obx(
  () => PageStateBuilder(
    state: controller.state.value,
    errorMessage: controller.errorMessage.value,
    onRetry: controller.loadData,
    successBuilder: (_) => MyContentWidget(),
  ),
);

---

🧩 Customizing

You can pass your own loading and error widgets:

PageStateBuilder(
  state: myState,
  successBuilder: (_) => MySuccessWidget(),
  loadingBuilder: (_) => CircularProgressIndicator(),
  errorBuilder: (context) => MyCustomErrorWidget(),
);

---

📘 API Reference

Parameter	Type	Description
state	PageState	Required. Current state of the widget.
successBuilder	WidgetBuilder	Required. Builder for success state UI.
loadingBuilder	WidgetBuilder?	Optional. Custom widget for loading state.
errorBuilder	WidgetBuilder?	Optional. Custom widget for error state.
onRetry	VoidCallback?	Optional. Retry callback for error state.
errorMessage	String?	Optional. Message to show when in error state.

---

📦 PageState Enum

enum PageState {
  loading,
  success,
  error,
}

Use this enum to manage your UI flow more cleanly.

---

🧪 Example

final controller = Get.put(MyController());

PageStateBuilder(
  state: controller.pageState,
  errorMessage: controller.errorMessage,
  onRetry: controller.fetchData,
  successBuilder: (_) => MyDataView(),
);

---

📄 License

MIT License © 2025 [ KlevaCode ]

---

❤️ Contributing

Feel free to fork and improve this widget. PRs are welcome!

---

---