https://github.com/mk590901/idle_timeout

The repository contains a demo application implements blocking itself by timeout.
https://github.com/mk590901/idle_timeout

bloc blocking dart flutter

Last synced: 9 months ago
JSON representation

The repository contains a demo application implements blocking itself by timeout.

• Host: GitHub
• URL: https://github.com/mk590901/idle_timeout
• Owner: mk590901
• Created: 2025-04-03T09:48:52.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-04-15T04:58:54.000Z (12 months ago)
• Last Synced: 2025-07-15T02:11:18.609Z (9 months ago)
• Topics: bloc, blocking, dart, flutter
• Language: Dart
• Homepage:
• Size: 97.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Idle-Timeout-Flutter 

The application locks itself if there is no touch in the drawing area for a specified time. In this case, the icon of the lock appears on the canvas. By clicking on it, the user unlocks the application and can continue drawing.

## Inside Application

The main widget is __IdleTimeoutWrapper__ will track application activity. It's a stateless widget that is driven by __BLoC__ events and keeps track of itself internal states.

### Main Points

> __BLoC__

  * __Events__ defined: __ResetTimer__, __LockApp__, __UnlockApp__, __AddPoint__ and __ClearPoints__

  * __IdleState__ it's a class with two fields: __isLocked__ and __points__

  * __IdleBloc__ manages the timer logic and states

     

> __StatelessWidget__

  * __IdleTimeoutWrapper__ is stateless

  * Uses __BlocProvider__ to create __BLoC__

  * __BlocBuilder__ rebuilds UI when state changes

     

> __Logic__

  * _Timer_ is managed in __BLoC__

  * _Events_ are sent via _context.read().add()_

  * __UI__ only reacts to the current state

> __DrawingPainter__

  * Created __CustomPainter__ for drawing lines

  * Take a list of points and draw lines between them

  * Uses orange color with line width 2.0

    

> ___DrawingCanvas__

  * StatelessWidget for managing drawing state

  * Stores a list of points _points

  * Handles drawing gestures only in unlocked state

  * Creates a __ValueNotifier__ to pass to __AnimatedLock__

  * Resets __isTappedNotifier__ to false after unlocking

    

> __Drawing logic__

  * __onPanStart__: starts a new line

  * __onPanUpdate__: adds points when moving

  * __onPanEnd__: adds null to break line

> __AnimatedLock__

 * Full StatelessWidget

 * Accepts a __ValueNotifier__ to control the icon state

 * Uses a __ValueListenableBuilder__ to listen for changes to __isTappedNotifier__

> __Integration__

  * __CustomPaint__ added to _Stack_ in any case

  * Drawing is active only when the app is __unlocked__

  * __Timer__ resets on all interactions

  * __AnimatedLock__ added to _Stack_ only when the app is locked

> __How it works__

* Initially, a closed lock is shown (__Icons.lock__)

* When pressed, the icon immediately changes to an open lock (__Icons.lock_open__)

* After 0.5 seconds, the application is unlocked and the icon state is reset

## Movie

https://github.com/user-attachments/assets/12512087-abc5-4aab-bc20-7118a6689d6d

## Additions

Another change has been made to the application, which solves the problem of screen orientation. I prefer that the application runs exclusively in __portrait__ mode on the __phone__, and in __landscape__ on the __tablet__.

As know, starting with __Android 14__, the __android:screenOrientation__ attribute in the __application manifest__ is considered obsolete and now the orientation must be set manually in the application. By the way, this solution seems quite reasonable, since setting the orientation in the manifest is too strict a restriction.

Another element has been added to the application: __OrientationBlob__, which determines the device type and sets the orientation of the application according to my above mentioned preference.

To determine the device type, the dart package __Sizer__ is used.

Below is another movie illustrating the launch of the application on a tablet __Android 14__.

## Movie II

https://github.com/user-attachments/assets/77b75d80-df6e-4a1c-9b4a-78866bf2c08c