blue_screen 1.0.1 blue_screen: ^1.0.1 copied to clipboard
A BlueScreen widget replaces the default ErrorWidget used for Flutter apps.
blue_screen #
A BlueScreen widget replaces the default ErrorWidget used for Flutter apps.
The Blue Screen of Death (BSoD), Blue screen error, Blue Screen, fatal error, or bugcheck, and officially known as a Stop error, is a critical error screen displayed by the Microsoft Windows and ReactOS operating systems in the event of a fatal system error. The Blue Screen of Death indicates a system crash, in which the operating system has reached a critical condition where it can no longer operate safely. Possible issues include hardware failure, an issue with or without a device driver, or unexpected termination of a crucial process or thread.
Features #
- Support run app in a safe mode with
runSafeMode
function or wrap widgets in aSafeModeBuilder
to avoid throw an exception when run app in release mode. - You can use a
BlueScreenWidget
instead of the defaultErrorWidget
of Flutter to show error messages withBlueScreenBuilder
widget or use it likes other widgets in your app.
Safe mode is a diagnostic mode of a computer operating system (OS). It can also refer to a mode of operation by application software. Safe mode is intended to help fix most, if not all, problems within an operating system. It is also widely used for removing rogue security software.
Getting started #
Add the package to the app #
- To add the
blue_screen
package as a dependency, run this command in your project terminal:
flutter pub add blue_screen
See more details at Installing page.
Declare the font assets (optional) #
- Now that you've imported the package, tell Flutter where to find the fonts from the
blue_screen
. - To declare fonts in this package, prefix the path to the font with
packages/blue_screen
. This tells Flutter to look in thelib
folder of the package for the font.
See all fonts and other data assets at here.
flutter:
fonts:
- family: <font_name>
fonts:
- asset: packages/blue_screen/fonts/<file_name>
- To use fonts in this package, declare which font you'd like to use like this.
...
fontFamily: '<font_name>',
...
Usage #
See complete example at Example page.
import 'package:blue_screen/blue_screen.dart';
/// Flutter code sample for [BlueScreenWidget].
void main() {
// Put the app in a safe mode.
runSafeMode(() {
// Start the app.
runApp(const BlueScreenExampleApp());
});
}
Additional information #
Please request features and bugs for us at the issue page.