CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flutter-background-execution

Implement, debug, or verify Flutter work that must continue or be scheduled after the app leaves the foreground, including OS-scheduled jobs, foreground services, and headless callbacks. Use for persistent background execution; route in-process async or CPU work to dart-concurrency and notification delivery to flutter-notifications.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is thiennc-tesoglobal/flutter-skills

SKILL.md
Quality
Evals
Security

Flutter Background Execution

Treat background execution as an operating-system contract, not a Dart timer that is guaranteed to keep running. Preserve the project's scheduler or plugin when it satisfies the requirement; inspect pubspec.yaml, SDK constraints, target platforms, native capabilities, and existing registration before changing it.

Define the job

Record the trigger, acceptable delay, maximum duration, survival across process death or reboot, network/power constraints, user visibility, cancellation, and what should happen after sign-out or data deletion. Separate “must eventually run” from “must run at an exact time”; mobile schedulers are commonly opportunistic.

Choose the owner

  • Keep work in dart-concurrency when it only needs to run while the app process is alive.
  • Use an OS-backed scheduler for deferrable work that must survive the visible app.
  • Use a user-visible foreground or continued-processing mode only when the platform permits the use case and its disclosure, permissions, and limits are satisfied.
  • Route exact user reminders and notification delivery to flutter-notifications.
  • Route a custom native scheduler bridge or reusable plugin implementation to flutter-platform-integration.

Do not add a scheduling package by default. Verify platform coverage, maintenance, target SDK support, callback model, and the repository's existing dependencies first.

Load details conditionally

  • Read Android scheduling and services for WorkManager, foreground services, exact alarms, reboot behavior, or Android permissions.
  • Read Apple background tasks for BGTaskScheduler, refresh/processing work, expiration, capabilities, or iOS scheduling expectations.
  • Read headless execution and reliability for callback dispatchers, isolates, plugin access, retries, deduplication, or durable progress.

Verification

Test the job body behind a platform-free boundary, including success, retryable failure, permanent failure, cancellation, duplicate delivery, and stale identity. Then verify the native registration and lifecycle on every supported target: backgrounding, process termination, constraints, expiration or timeout, rescheduling, reboot when promised, and sign-out cleanup. Report actual device and lifecycle evidence; a successful direct function call does not prove OS scheduling.

Sources

  • Flutter background processes
  • Android persistent work
  • Apple Background Tasks
Repository

thienqo/flutter-skills

Path

skills/flutter-background-execution/SKILL.md

Last updated
First committed

Canonical home

thiennc-tesoglobal/flutter-skills
In sync

since Aug 27, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.