NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #4529 most downloaded on pub.dev
Micro-framework for Flutter that's built to simplify app development for Flutter projects.
Latest stable
7.5.1
Last release 21 days ago
01 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
312 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Bump nylo_support dependency from ^7.37.0 to ^7.37.1, which brings:
nylo_support dependency from ^7.37.0 to ^7.37.1, which brings:
NyBaseModal.show(backgroundColor:) colors the modal's content area as well as its frame, so one color covers the whole sheet; modalBackgroundColor sets the content area to its own colormetro doctor checks how a project is wired up (routes, decoders, languages, env and assets) and exits non-zero when something is wired wrong. metro do
metro doctor checks how a project is wired up (routes, decoders, languages, env and assets) and exits non-zero when something is wired wrong. metro doctor --strict also fails on notes worth a lookmetro make:model <name> --one-of="accepted,rejected" creates a sealed parent with one subtype per name and registers a OneOf.byKey entry for it in decoders.dart. Pass --one-of on its own to be asked for the subtype namesmetro make:playbook <name> --from-routes creates a playbook that visits every page the router adds and takes a screenshot of eachmetro live:run screenshot saves a PNG of the running app, with --area for one ScreenshotArea, --store and --frame for app store sizes, and --open or --copy once it's savedmetro live:run playbook <name> saves the playbook's screenshot() steps under screenshots/<playbook>/, and takes --locales and --themes to capture each screen in every language and theme, --store, --frame and --background for store listings, and --clean-status-bar for 9:41 with full signal and battery on native capturesnylo_support dependency from ^7.36.0 to ^7.37.0, which brings:
Screenshot.capture() and Screenshot.area() for PNGs of the app's screen, sized for App Store and Google Play listings with forStore()NyDecoder, Decode and OneOf typed decoders, with NyResponse.dataAs<X>() and dataIs<X>() to read a OneOf responseFormFieldStyle (filled, outlined, underlined, grouped) and NyFieldColors, so form fields follow the app's themepreviewRoute(data:, queryParameters:, stack:), NyApp.refreshLocale() and NyThemeManager.showTheme()StyledText text color, and themed text that follows a change of themeYour coding agent can read these notes before it upgrades. Set up the MCP server →
Bump nylo_support dependency from ^7.34.0 to ^7.35.0, which brings:
nylo_support dependency from ^7.34.0 to ^7.35.0, which brings:
Find.icon takes an optional label that names the icon in captions and reports, so Find.icon(Icons.shopping_bag_outlined, label: 'bag') reads "Tap the bag icon"NyTest.init adds an event bus when the app has none, so a form's submit button reaches its form in widget testsmetro live playbook runs stop waiting when no step reaches Metro within 20 seconds, and explain why: the app is playing but its events aren't arriving, as happens with an app started with flutter run --no-ddsBump nylo_support dependency from ^7.33.1 to ^7.34.0, which brings:
nylo_support dependency from ^7.33.1 to ^7.34.0, which brings:
Field.textArea (or any multi-line field) with a prefixIcon floats its label to the same start position as single-line fields (#309)PrefixIconAlignment.top, set through FieldStyleTextField(prefixIconAlignment: ...) or InputField(prefixIconAlignment: ...), lines a multi-line field's prefix icon up with its first line of text (#309)Bump nylo_support dependency from ^7.33.0 to ^7.33.1, which brings:
nylo_support dependency from ^7.33.0 to ^7.33.1, which brings:
onChanged with null, and the cleared field is validated as empty, so FormValidator.notEmpty() fails again (#311)flutter_local_notifications ^22.3.2, timezone ^0.11.2 and flutter_timezone ^5.1.1Recording playbooks - metro live:run playbook --record records the device's screen around the run and saves it to build/playbooks/ - - .mp4, or to the
metro live:run playbook <name> --record records the device's screen around the run and saves it to build/playbooks/<playbooks>-<device>-<time>.mp4, or to the file given with --record=demo.mp4 (or .gif). Recording needs ffmpeg. It uses simctl on the iOS Simulator, and adb screenrecord (up to 3 minutes) or scrcpy when it's installed on Android. A run that fails or is stopped is still saved, so a recording doubles as a bug report. Inside metro live it's playbook <name> --record
.vtt file beside the .mp4, and a chapter in it. --no-captions leaves them out--clean-status-bar shows 9:41 with full signal and battery while the playbooks play, and puts the status bar back afterwards. A simulator status bar you've already set is kept--countdown <seconds> counts down on screen before the first step, e.g. to start QuickTime or Control Center recording on an iPhonemake:playbook stub spells out showFinger and caption, and how to record the playbooknylo_support dependency from ^7.32.0 to ^7.33.0, which brings:
showFinger => true and caption => PlaybookCaption.bottom (or .top) to show themstatus, and Nylo Live protocol 10Playbooks - A playbook is a class listing the taps, typing, scrolling and page changes of a user journey, which the running app then performs on itsel
run(), and in widget and integration tests, and playbooks can play each other
metro make:playbook <name> - Creates lib/app/playbooks/<name>_playbook.dart, registers it in lib/bootstrap/playbooks.dart (created on first use, and an empty map in release builds) and passes playbooks to nylo.configure(...) in your app provider. Takes --description and --force, and subfolders like make:playbook onboarding/sign_upmetro live:run playbook <name> [<name> ...] - Plays playbooks back to back in the running app, printing each step as it happens. Takes --speed instant|fast|natural|slow, --data <json> (shared by every playbook in the run), --no-overlay and --loop. Without names, or with --list, it lists the app's playbooks. Ctrl+C asks the app to stop, which skips the remaining steps but still runs tearDown; a second Ctrl+C stops waiting. Inside metro live it's playbook <name>, and Tab completes playbook namespackage:nylo_framework/playbook.dart - The library playbooks and lib/bootstrap/playbooks.dart importnylo_support dependency from ^7.31.4 to ^7.32.0, which brings:
make:playbook and live:run playbook, PLAYBOOK_ON_BOOT, and the NyTesterClock testing helpersNyFormPicker laid out like a text field, with FieldStylePicker.decoration and prefixIconNyLogger no longer throws before Nylo startsmetro live, a command that watched the app's events cancelled the stream the shell itself uses to follow page changesBump nylo_support dependency from ^7.31.3 to ^7.31.4, whose refreshToken once more receives a new Dio, separate from the service's client and its inte
nylo_support dependency from ^7.31.3 to ^7.31.4, whose refreshToken once more receives a new Dio, separate from the service's client and its interceptors, so an interceptor that reacts to auth cannot trigger itself during a token refreshBump nylo_support dependency from ^7.31.2 to ^7.31.3, which brings:
nylo_support dependency from ^7.31.2 to ^7.31.3, which brings:
syncKeys reads storage onceNumberFormats and validation patterns compiled once and reusedContent-Length instead of stringifying the body; NY_API_LOGS keeps a request summary and is skipped in release buildsrefreshToken receives the service's own Dio, sharing its base URL, headers and connection poolNylo.hasApiDecoder<T>(), FormValidationResult.firstError and BaseThemeConfig.invalidateThemeData()vibe_check instead of flutter_lintsBump nylo_support dependency from ^7.31.1 to ^7.31.2, which brings:
nylo_support dependency from ^7.31.1 to ^7.31.2, which brings:
monitorAppUsage() on, that launch goes unrecorded and the error is logged instead of thrown out of the bootsetLoading works after its page has closed, so async work that finishes late, such as a CollectionView refresh, no longer calls setState on a disposed stateBump nylo_support dependency from ^7.31.0 to ^7.31.1, whose handleFailure works when a request throws (by default, any status outside 2xx). A callback
nylo_support dependency from ^7.31.0 to ^7.31.1, whose handleFailure works when a request throws (by default, any status outside 2xx). A callback that returns nothing, plain or async, gets the error response, and one that returns a value gets that value as the response's data; both used to end in a TypeErrorBump nylo_support dependency from ^7.30.1 to ^7.31.0, which brings:
nylo_support dependency from ^7.30.1 to ^7.31.0, which brings:
Storage facade, e.g. disk('documents').put('reports/q3.pdf', bytes) or FileStorage.put(...) for the default disk. local, documents, cache, temp and assets disks work without any configuration, and nylo.configure(disks: ..., defaultDisk: ...) adds your own. putFile stores an XFile from image_picker, file_picker or camera, DiskImage shows a stored image, and FileStorage.fake() and FakeFile cover tests (NyTest.init() fakes every writable disk)lockRelease(onError:), which receives an Exception thrown by perform once the lock is releasedField.date stays empty until a date is chosen, Field.picker grows to fit larger text, Field.chips shows which chips are selected in dark mode, and the password visibility toggle is a labelled buttonmetro make:seeder's generated lib/bootstrap/seeders.dart comment drops the "release builds get an empty map" note and reflows the "no need to edit thi
metro make:seeder's generated lib/bootstrap/seeders.dart comment drops the "release builds get an empty map" note and reflows the "no need to edit this file" linepackage:nylo_framework/nylo_framework.dart exports Flutter's painting API again (Locale, Color, TextStyle, EdgeInsets, BorderRadius, BoxDecoration, ..
package:nylo_framework/nylo_framework.dart exports Flutter's painting API again (Locale, Color, TextStyle, EdgeInsets, BorderRadius, BoxDecoration, ...). It used to arrive through skeletonizer 2, which exports package:flutter/painting.dart; skeletonizer 3 doesn't, so in 7.2.0 and 7.2.1 a file that used these types with only the nylo_framework import stopped compiling, e.g. List<Locale> supportedLocales in the boilerplate's lib/config/localization.dart. nylo_framework now exports package:flutter/painting.dart itselfBump nylo_support dependency from ^7.30.0 to ^7.30.1, whose dartdoc for Seeder, StorageSnapshot, LiveCommand and Nylo.addSeeders now names the command
nylo_support dependency from ^7.30.0 to ^7.30.1, whose dartdoc for Seeder, StorageSnapshot, LiveCommand and Nylo.addSeeders now names the commands you type inside metro live (seed, seed:rollback, export, seed <file>) instead of metro live:* commands that don't existNylo Live - Metro can now reach into your app while it runs in debug mode, through the Dart VM service. It finds the running app through the Dart Tool
metro live - Opens a shell connected to the running app, where live commands drop their prefix (status, route /profile). The prompt shows the device and current route, Tab completes commands, options, routes, storage keys and seeders, history is kept in .dart_tool/nylo/live_history, and the shell reconnects when the app restarts. seed, seed:rollback, export, reload and restart only run inside the shell. Piping a file in (metro live < seeds/demo.live) runs it one line at a time and stops at the first command that failsmetro live:devices - Lists this project's running apps, numbered for -dmetro live:status - Shows the app, device, build mode, current route and stack, locale, theme, and whether a user is signed inmetro live:run <command> - Runs a built-in command: data (the page on screen, the route data it was opened with, and its state's own fields), routes, route, back, deeplink (also lists the link schemes declared in your iOS and Android config), storage, storage:clear, backpack, auth, locale, theme, state, event and toast-d/--device <#|name>, --all (every running app), --json, --uri (a VM service address, skipping discovery) and --timeout. An option value written @path is read from that file, e.g. --data @user.json (@@ for a literal @)metro make:command <name> --live creates a LiveCommand, which runs inside your app and has the same builder/handle shape as a Metro command. Metro marks it "type": "live" in lib/app/commands/commands.json, registers it in lib/bootstrap/live_commands.dart (an empty map in release builds) and passes liveCommands to nylo.configure in app_provider.dart. Run it with metro <category>:<name> while the app is running. --description sets the line shown for it under [Live Commands] in the Metro menumetro make:seeder <name> creates a Seeder in lib/app/seeders/, registers it in lib/bootstrap/seeders.dart and passes seeders to nylo.configure. Inside metro live, seed <name> runs its up() and seed:rollback <name> puts back every storage and Backpack value it changed; seed on its own lists the seeders. --fresh clears storage and Backpack first, and --restart hot restarts the app afterwardsexport [name] inside metro live saves the app's storage and Backpack as a seeder in lib/app/seeders/, or as a JSON file with --to, and seed <file> loads a snapshot file back. --only and --except take comma-separated keys with * wildcards, and --no-backpack leaves Backpack out. Models, and any class with a registered decoder, come back as their own class. export warns when the snapshot holds keys that look like credentialsmake:page adds static final actions = path.actions; to the page class, so other code can call it, e.g. HomePage.actions.showToast("hello")package:nylo_framework/live.dart exports the live API (LiveCommand, Seeder, StorageSnapshot, LiveException, LiveOutput) for live commands and seedersmake:page (with or without --controller) now generates bool get stateManaged => true instead of false, so the page receives the actions sent to it. Existing pages are unchanged; to call one through actions, add both lines to it[Live Commands] section listing live, live:devices, live:status and live:run, followed by the project's own live commands (listed there instead of under [Custom Commands])nylo_support dependency from ^7.29.0 to ^7.30.0, which brings:
Seeder, StorageSnapshot and typed page actions (PageStateActions)nylo.* translation keys, used when your lang/ files don't have the keyNyFormWidget.submit returns a Future<void> that completes once onSuccess or onFailure has finishedlockRelease releases its lock whatever perform throws, and LocalNotification falls back to an inexact alarm on Android 14+ when exact alarms aren't permittedskeletonizer dependency from ^2.1.3 to ^3.0.0, which nylo_support 7.30.0 also requires. Skeletonizer 3 breaks apps that use its API directly through nylo_framework's export: SkeletonizerConfigData is no longer a ThemeExtension (provide it with SkeletonizerConfig(data: ..., child: ...)), SkeletonizerConfigData.light() and .dark() are removed, and BoneButtonType.elevated/filled/text are renamed to prominent/prominent/plain. Code that only uses Nylo's LoadingStyle.skeletonizer() needs no changesflutter_local_notifications dependency from ^22.3.0 to ^22.3.1patrol dev dependency from ^4.9.0 to ^4.10.0actions/checkout@v5 (was @v3)make:api_service stops with exit code 1 when the file already exists and --force isn't passed. It used to print "already exists" and carry on, reformatting the existing file and exiting 0Bump dio dependency from ^5.11.0 to ^5.11.1
dio dependency from ^5.11.0 to ^5.11.1yaml dependency from ^3.1.3 to ^3.1.4make:button stub now uses explicit type annotations instead of inferred types in its generated codeMetro discovers commands shipped by packages - When a dependency of your project contains a metro_commands.json file at its root, its commands appear
metro_commands.json file at its root, its commands appear in the metro menu under [<package> Commands] and run like any other command, e.g. metro tenant:create. Nothing needs to be registered in the project. The "Package Commands" section of the Commands documentation covers how to ship commands in a packagemetro now exits with the exit code of the custom command it ran, instead of always 0make:page), or with a command from another source, is skipped with a warning naming both sides instead of being listed but never runnylo_support dependency from ^7.28.0 to ^7.29.0Bump nylo_support dependency from ^7.27.5 to ^7.28.0, which brings:
nylo_support dependency from ^7.27.5 to ^7.28.0, which brings:
name and path constructor parameters on NavigationHub, plus NyStatefulWidget.declaredStateName, so a hub and the NavigationHubStateActions driving it can agree on a single state nameflutter build --obfuscate)NyPage no longer adopts another page's state data on init, and JourneyState.isLastStep no longer reports true for a journey with no stepsNyLogger.error now reports routes whose builder names no page, and NavigationHubStateActions calls addressing a name no hub listens onpatrol is now a dev dependency (was a regular dependency) and bumped from ^4.8.0 to ^4.9.0 — consumer apps no longer pull in patrol transitively; add
patrol is now a dev dependency (was a regular dependency) and bumped from ^4.8.0 to ^4.9.0 — consumer apps no longer pull in patrol transitively; add it to your own dev_dependencies if your tests use itnylo_support dependency from ^7.27.4 to ^7.27.5flutter_local_notifications dependency from ^22.2.0 to ^22.3.0build/ and platform folders (android/, ios/, web/, windows/, macos/, linux/) in analysis_options.yamlBump nylo_support dependency from ^7.27.3 to ^7.27.4
nylo_support dependency from ^7.27.3 to ^7.27.4flutter_local_notifications dependency from ^22.0.1 to ^22.2.0dio dependency from ^5.10.0 to ^5.11.0error_stack dependency from ^2.1.4 to ^2.1.5patrol dependency from ^4.6.1 to ^4.8.0\make:api_service\ — acronym-spelled names (e.g. \PaymentsAPIService\) no longer produce a doubled \ApiServiceApiService\ class name; the suffix is no
Bump nylo_support dependency from ^7.27.1 to ^7.27.2
nylo_support dependency from ^7.27.1 to ^7.27.2flutter_local_notifications dependency from ^21.0.0 to ^22.0.0^3.12.0 and Flutter >=3.44.0Bump nylo_support dependency from ^7.26.2 to ^7.27.1
nylo_support dependency from ^7.26.2 to ^7.27.1patrol dependency from ^4.6.0 to ^4.6.1Improved make:interceptor Metro stub: added docstrings for onRequest, onResponse, and onError, and replaced super.onRequest(...) with handler.next(opt
make:interceptor Metro stub: added docstrings for onRequest, onResponse, and onError, and replaced super.onRequest(...) with handler.next(options) so the generated interceptor passes the request through explicitlyUpdated make:state_managed_widget Metro stub to use the new NyStateManaged API with baseState/id instead of stateName, simplifying the generated widge
make:state_managed_widget Metro stub to use the new NyStateManaged API with baseState/id instead of stateName, simplifying the generated widgetBump nylo_support dependency from ^7.26.1 to ^7.26.2
nylo_support dependency from ^7.26.1 to ^7.26.2error_stack dependency from ^2.1.3 to ^2.1.4Bump nylo_support dependency from ^7.26.0 to ^7.26.1
nylo_support dependency from ^7.26.0 to ^7.26.1collection dependency from ^1.18.0 to ^1.19.1patrol dependency from ^4.5.0 to ^4.6.0New make:deep_link_provider Metro command to scaffold a deep link provider pre-wired for Nylo's deep-link capture
make:deep_link_provider Metro command to scaffold a deep link provider pre-wired for Nylo's deep-link capturenylo_support dependency from ^7.24.2 to ^7.26.0^3.10.7 and Flutter >=3.38.4collection dependency constraint from ^1.19.1 to ^1.18.0Bump nylo_support dependency from ^7.24.1 to ^7.24.2
nylo_support dependency from ^7.24.1 to ^7.24.2error_stack dependency from ^2.1.2 to ^2.1.3Bump nylo_support dependency from ^7.24.0 to ^7.24.1
nylo_support dependency from ^7.24.0 to ^7.24.1Bump nylo_support dependency from ^7.23.1 to ^7.24.0
nylo_support dependency from ^7.23.1 to ^7.24.0Bump nylo_support dependency from ^7.23.0 to ^7.23.1
nylo_support dependency from ^7.23.0 to ^7.23.1error_stack dependency from ^2.1.1 to ^2.1.2Bump nylo_support dependency from ^7.22.0 to ^7.23.0
nylo_support dependency from ^7.22.0 to ^7.23.0make:state_managed_widget stub to use the new NyStateManaged base widget, enabling multi-instance state isolation via stateNameBump nylo_support dependency from ^7.21.0 to ^7.22.0
nylo_support dependency from ^7.21.0 to ^7.22.0Bump nylo_support dependency from ^7.20.2 to ^7.21.0
nylo_support dependency from ^7.20.2 to ^7.21.0Bump nylo_support dependency from ^7.20.0 to ^7.20.2
nylo_support dependency from ^7.20.0 to ^7.20.2error_stack dependency from ^2.0.1 to ^2.1.1Bump nylo_support dependency from ^7.19.0 to ^7.20.0
nylo_support dependency from ^7.19.0 to ^7.20.0Bump nylo_support dependency from ^7.18.1 to ^7.19.0
nylo_support dependency from ^7.18.1 to ^7.19.0Bump nylo_support dependency from ^7.16.0 to ^7.18.1
nylo_support dependency from ^7.16.0 to ^7.18.1Remove --force flag from make:key command, now always overwrites existing APP_KEY
--force flag from make:key command, now always overwrites existing APP_KEYstateManaged to false by defaultRemove --force flag from make:env command, now always overwrites existing env.g.dart
--force flag from make:env command, now always overwrites existing env.g.dartnylo_support dependency from ^7.14.1 to ^7.15.0Bump nylo_support dependency from ^7.14.0 to ^7.14.1
nylo_support dependency from ^7.14.0 to ^7.14.1Full Changelog: https://github.com/nylo-core/framework/compare/v7.1.3...v7.1.4
Bump nylo_support dependency from ^7.13.0 to ^7.14.0
nylo_support dependency from ^7.13.0 to ^7.14.0Bump nylo_support dependency from ^7.12.0 to ^7.13.0
nylo_support dependency from ^7.12.0 to ^7.13.0Full Changelog: https://github.com/nylo-core/framework/compare/v7.1.1...v7.1.2
Page stub now sets stateManaged to false by default for newly scaffolded pages
stateManaged to false by default for newly scaffolded pagesSubdirectory support for all make:* Metro commands — users can now specify paths like make:stateless_widget login/BrandPanel to organize generated fil
make:* Metro commands — users can now specify paths like make:stateless_widget login/BrandPanel to organize generated files into subdirectoriesnylo_support dependency from ^7.11.2 to ^7.12.0patrol dependency from ^4.3.0 to ^4.5.0Bump nylo_support dependency from ^7.11.1 to ^7.11.2
nylo_support dependency from ^7.11.1 to ^7.11.2Bump nylo_support dependency from ^7.10.0 to ^7.11.1
nylo_support dependency from ^7.10.0 to ^7.11.1flutter_local_notifications dependency from ^20.1.0 to ^21.0.0Bump nylo_support dependency from ^7.9.1 to ^7.10.0
nylo_support dependency from ^7.9.1 to ^7.10.0patrol dependency from ^4.2.0 to ^4.3.0Bump nylo_support dependency from ^7.9.0 to ^7.9.1
nylo_support dependency from ^7.9.0 to ^7.9.1## Changes - Bump version to 7.0.11 - Update nylo_support to ^7.9.0 - Update patrol to ^4.2.0
nylo_support to ^7.9.0patrol to ^4.2.0nylo_support dependency from ^7.8.1 to ^7.9.0patrol dependency from ^4.1.1 to ^4.2.0Bump nylo_support dependency from ^7.7.0 to ^7.8.1
nylo_support dependency from ^7.7.0 to ^7.8.1skeletonizer dependency from ^2.1.2 to ^2.1.3flutter_local_notifications dependency from ^20.0.0 to ^20.1.0dio dependency from ^5.9.0 to ^5.9.2error_stack dependency from ^2.0.0 to ^2.0.1patrol dependency from ^4.1.0 to ^4.1.1Bump nylo_support dependency from ^7.6.0 to ^7.7.0
nylo_support dependency from ^7.6.0 to ^7.7.0Bump nylo_support dependency from ^7.5.0 to ^7.6.0
nylo_support dependency from ^7.5.0 to ^7.6.0Simplify API service stub constructor by removing BuildContext parameter — generated API services now use a no-argument constructor with super(decoder
BuildContext parameter — generated API services now use a no-argument constructor with super(decoders: modelDecoders)package:flutter/material.dart import from API service stub since BuildContext is no longer neededimport ' prefix)Bump nylo_support dependency from ^7.4.0 to ^7.5.0
nylo_support dependency from ^7.4.0 to ^7.5.0Bump nylo_support dependency from ^7.3.1 to ^7.4.0
nylo_support dependency from ^7.3.1 to ^7.4.0Bump nylo_support dependency from ^7.3.0 to ^7.3.1
nylo_support dependency from ^7.3.0 to ^7.3.1Bump nylo_support dependency from ^7.2.0 to ^7.3.0
nylo_support dependency from ^7.2.0 to ^7.3.0library nylo_framework.metro for clearer sub-library namingJsonDef.customObjectString getterOne column per quarter.