Widget overview
This page catalogs every reusable Flutter widget in lib/, grouped by folder. Check this list before adding a new widget — a similar one may already exist.
There is no lib/widgets/ directory. Widgets live under lib/views/, either in the generic, app-wide lib/views/components/ tree, or in a screen-local components/ subfolder next to the screen that uses them.
Each line follows the format path — WidgetClassName — description, to keep this page easy to grep.
Folders
lib/views/- components/ — generic, app-wide widgets with no screen-specific dependency.
- animations/ — reusable fade/rotate/Lottie animation wrappers.
- buttons/ — generic dialog-style buttons.
- config/ — widgets that adapt behavior to app configuration/settings.
- content/ — widgets that render document content such as Markdown.
- dialogs/ — generic modal dialogs used across the app.
- imaging/ — image/camera rendering and transform widgets.
- indicators/ — small status/progress indicator widgets.
- transitions/ — page-transition animation widgets.
- base/ — MVVM screen base classes and routing-page infrastructure.
- onboarding_screen/components/ — chrome for the first-run onboarding wizard.
photo_booth_screen/- components/ — top-level wrappers for the main booth screen (activity tracking, scaling, FPS overlay).
screens/- components/buttons/ — themed booth action/navigation button.
- components/text/ — auto-sizing themed title/subtitle text.
- gallery_screen/components/ — gallery-screen-local toolbar widgets.
- theme/*/components/ — decorative widgets specific to one visual theme.
settings_overlay/- components/ — chrome for the settings overlay (pages, sections, dialogs).
- components/settings/ — one row-widget per setting type, plus the “quick actions” grid buttons.
- components/print_routing_editor/ — node editor for the print routing graph.
- components/ — generic, app-wide widgets with no screen-specific dependency.
- Menus / app-level widgets — top-level
lib/widgets outside theviews/tree. - Known near-duplicates / naming overlaps — intentional or confusable look-alike widgets to check before adding a new one.
lib/views/components/
Generic, app-wide widgets with no screen-specific dependency.
lib/views/components/qr_code.dart—QrCode— renders a QR code of givendata/size.lib/views/components/cvs_simulation_filter.dart—CvsSimulationFilter— wrapschildin color filters to simulate color-vision deficiency.
lib/views/components/animations/
Reusable fade/rotate/Lottie animation wrappers.
animated_delayed_fade_in.dart—AnimatedDelayedFadeIn— fades inchildafter a configurable delay.fading_text_swticher.dart—FadingTextSwitcher— cycles through a list of strings with a fade + auto-resize animation.lottie_animation_wrapper.dart—LottieAnimationWrapper— overlays positioned/rotated Lottie animations on top ofchild.pulsating_opacity.dart—PulsatingOpacity— continuously fadeschildbetween a min and max opacity (e.g. a blinking “recording” dot).repeating_indicator.dart—RepeatingIndicator— periodically shows a Lottie animation at a random position (idle attention-grabber).rotating_collage_box.dart—RotatingCollageBox— animates rotation of a collage widget when theturnsprop changes.
lib/views/components/buttons/
Generic dialog-style buttons.
photo_booth_filled_button.dart—PhotoBoothFilledButton— dialog-style filled button with optional icon + title.photo_booth_outlined_button.dart—PhotoBoothOutlinedButton— outlined variant ofPhotoBoothFilledButton.
Note: these are generic dialog buttons, not the same as
PhotoBoothButtoninphoto_booth_screen/screens/components/buttons/(themed booth action/nav button). Three “PhotoBooth*Button” widgets exist across the codebase — pick carefully.
lib/views/components/config/
Widgets that adapt behavior to app configuration/settings.
set_scroll_configuration.dart—SetScrollConfiguration— wrapschildin aScrollConfigurationthat conditionally allows mouse-drag scrolling.
lib/views/components/content/
Widgets that render document content.
markdown_view.dart—MarkdownView— renders Markdown (viaflutter_markdown_plus) with a Fluent UI style sheet, opening links in the browser.
lib/views/components/dialogs/
Generic modal dialogs used across the app.
enter_pin_dialog.dart—EnterPinDialog— numeric keypad dialog for entering a PIN code.find_face_dialog.dart—FindFaceDialog— live view + countdown to capture a face photo for face-recognition lookup.gphoto2_camera_warning_dialog.dart—GPhoto2CameraWarningDialog— SD-card corruption warning shown the first time a camera model is selected for gPhoto2;confirmIfNeeded()also remembers confirmed models.language_choice_dialog.dart—LanguageChoiceDialog— dialog listing available languages to pick.loading_dialog.dart—LoadingDialog— generic loading dialog (.generic()spinner,.cameraDownload()Lottie).modal_dialog.dart—ModalDialog— base styled modal container (title, body, type icon, actions), builds onPhotoBoothDialog. Used by most other dialogs.no_project_open_dialog.dart—NoProjectOpenDialog— shown when no project is open, lists recent projects.photo_booth_dialog.dart—PhotoBoothDialog— lower-level rounded-card dialog shell (width/height/title/indicator/body/actions), used underneathModalDialog.printer_issue_dialog.dart—PrinterIssueDialog— reports a stuck/failed printer with stuck-job list and resume/ignore actions.printing_error_dialog.dart—PrintingErrorDialog— generic printing error dialog with Lottie animation; says so when some prints may have started.print_dialog.dart—PrintDialog— choose print size (only those the photo can be printed at) and copy count; also exportsPrintSizeChoice.qr_share_dialog.dart—QrShareDialog— upload progress + QR code for sharing photos.retake_dialog.dart—RetakeDialog— confirm delete/keep a photo before retaking.settings_import_dialog.dart—SettingsImportDialog— preview settings-import diffs before applying.
Note:
ModalDialogvsPhotoBoothDialog— two layered generic dialog shells.ModalDialogis the one most feature dialogs should build on;PhotoBoothDialogis the lower-level shell it wraps.
lib/views/components/imaging/
Image/camera rendering and transform widgets.
image_with_loader_fallback.dart—ImageWithLoaderFallback— image loader with placeholder/fallback while decoding,.memory()/.file()constructors, optional rotate/flip/crop.live_view.dart—LiveView— renders the live camera-preview texture with rotate/flip/crop, overlay image and filter settings; animates the crop aspect ratio to 16:9 while the recording layout is active.live_view_background.dart—LiveViewBackground— conditionally shows a blurred/live camera feed as a full-screen background depending on route/settings.photo_collage.dart—PhotoCollage— renders a full photo collage (background/middle/foreground layers, logo, layout) from captured photos.quote_collage.dart—QuoteCollage— receipt-width (576 px) column with a recording snapshot, the transcript summary and an optional separator template;QuoteCollageState.getCollageImage()screenshots it for the receipt printer.rotate_flip_crop.dart—RotateFlipCrop— applies rotate/flip/aspect-ratio crop transforms to achild.
lib/views/components/indicators/
Small status/progress indicator widgets.
capture_counter.dart—CaptureCounter— animated countdown-number display before/during capture.connection_state_indicator.dart—MqttConnectionStateIndicator— small colored dot for MQTT connection state.onboarding_version_info.dart—OnboardingVersionInfo— app/Flutter/Rust version info footer.subsystem_status_display.dart—SubsystemStatusDisplay— expandable tile with a subsystem’s status/message/recovery actions.subsystem_status_icon.dart—SubsystemStatusIcon— maps aSubsystemStatusto a colored icon.subsystem_status_list.dart—SubsystemStatusList— observable list ofSubsystemStatusDisplaytiles.time_counter.dart—TimeCounter— elapsed-time display (mm:ss:mmm, animated digits) counting up totargetDuration; started viaTimeCounterState.startTimer().
lib/views/components/transitions/
Page-transition animation widgets.
fade_and_scale_transition.dart—FadeAndScaleTransition— page-transition: fade + scale in/out.fade_and_slide_transition.dart—FadeAndSlideTransition— page-transition: fade + horizontal slide in/out.
Both are theme-selectable variants consumed by transition_page.dart.
lib/views/base/
MVVM screen base classes and routing-page infrastructure.
full_screen_dialog.dart—FullScreenPopup— rounded, shadowed container used as full-screen popup chrome.screen_base.dart—ScreenBase<TViewModel, TController, TView>— abstract baseStatefulWidgetfor the app’s MVVM screen pattern.photo_booth_dialog_page.dart—PhotoBoothDialogPage<T>— routing page with blur+fade+scale transition for dialog routes.transition_page.dart—TransitionPage— routing page providing themed screen-transition animations (delegates to the twoFadeAnd*Transitionwidgets above).
lib/views/onboarding_screen/components/
Chrome for the first-run onboarding wizard.
onboarding_wizard.dart—OnboardingWizard— acrylic-panel chrome wrapper for onboarding wizard content.wizard_page.dart—WizardPage— standard onboarding wizard page layout with back/next navigation.
lib/views/photo_booth_screen/components/
Top-level wrappers for the main booth screen (activity tracking, scaling, FPS overlay).
activity_monitor.dart—ActivityMonitor— tracks user (in)activity, triggers timeout/return-to-home navigation.app_scaler.dart—AppScaler— scaleschilduniformly to fit the window relative to a fixed 1920x1080 target resolution.framerate_monitor.dart—FramerateMonitor— conditionally overlays an on-screen FPS counter based on debug settings.
lib/views/photo_booth_screen/screens/components/buttons/
Themed booth action/navigation button.
photo_booth_button.dart—PhotoBoothButton— themed booth action/navigation button,.action()/.navigation()constructors, wrapsAutoSizeTextAndIcon.
lib/views/photo_booth_screen/screens/components/text/
Auto-sizing themed title/subtitle text.
auto_size_text_and_icon.dart—AutoSizeTextAndIcon— text (optionally with icon) that auto-sizes to fit its box.photo_booth_subtitle.dart—PhotoBoothSubtitle— themed subtitle text usingAutoSizeTextAndIcon.photo_booth_title.dart—PhotoBoothTitle— themed title text usingAutoSizeTextAndIcon.
lib/views/photo_booth_screen/screens/gallery_screen/components/
Gallery-screen-local toolbar widgets.
filter_bar.dart—FilterBar— gallery toolbar with sort-order chooser and “find my face”/clear-filter buttons.filter_choice.dart—FilterChoice— segmented button to choose gallery sort order.
lib/views/photo_booth_screen/theme/*/components/
Decorative widgets specific to one visual theme.
theme/hollywood/components/hollywood_stars.dart—HollywoodStars— animated twinkling-stars background.theme/wedding/components/wedding_wreath.dart—WeddingWreath— animated rotating Lottie wreath decoration.
lib/views/settings_overlay/components/
Chrome for the settings overlay (pages, sections, dialogs).
aspect_ratio_preview.dart—AspectRatioPreview— small bordered box previewing a given aspect ratio.external_system_check_edit_dialog.dart—ExternalSystemCheckEditDialog— create/edit an external system health check.external_system_check_tile.dart—ExternalSystemCheckTile— expandable tile for an external system health check.openai_endpoint_edit_dialog.dart—OpenAiEndpointEditDialog— create/edit an OpenAI-compatible endpoint (name, base URL, API key).openai_endpoint_tile.dart—OpenAiEndpointTile— tile for an OpenAI-compatible endpoint, showing whether an API key is stored.open_source_licenses_expander.dart—OpenSourceLicensesExpander— About-page expander listing third-party licenses as compact tables (name, version, license) in lazily built groups; clicking a row opens a dialog with the license text.import_field.dart—MyDropRegion— drag-and-drop / clipboard-paste region for importing a TOML settings file. (Placeholder-style name — actually settings-import specific, not a generic drop region.)settings_list_page.dart—SettingsListPage— settings page variant rendering a scrollable list of setting “blocks”.settings_page.dart—SettingsPage— base settings-page chrome (title, scroll-shadowed body, “auto-saved” info bar);SettingsPage.fixedfills the space with a non-scrolling body instead.settings_section.dart—SettingsSection— titled vertical group wrapper for a list of setting widgets.update_secret_dialog.dart—UpdateSecretDialog— enter/save a new secret value (API key/password).
lib/views/settings_overlay/components/print_routing_editor/
The fl_nodes_v2 node editor for the print routing graph on the “Print routing” settings page.
print_routing_editor.dart—PrintRoutingEditor— node canvas with toolbar, Fluent context menus and keyboard shortcuts, a side panel listing the routes per print size and the problems, and a status line explaining refused connections.print_routing_node_card.dart—RoutingNodeCard— body of one node: header, port labels coloured by type, Fluent fields (incl. queue and media combo boxes for CUPS queues and for native printers that list their papers, inline printer margins) and notes; its rows followRoutingNodeLayout.
lib/views/settings_overlay/components/settings/
One row-widget per setting type, plus the “quick actions” grid buttons.
All settings tiles are built on settings_tile.dart — SettingsTile (base card row: icon, title, subtitle, trailing control):
settings_action_tile.dart—SettingsActionTile— button that triggers an action.settings_color_pick_tile.dart—SettingsColorPickTile— color swatch that opens a color picker.settings_combo_box_tile.dart—SettingsComboBoxTile<TValue>— dropdown/combo-box selector.settings_file_select_tile.dart—SettingsFileSelectTile— file-picker field (optionally clearable).settings_folder_select_tile.dart—SettingsFolderSelectTile— folder-picker field.settings_number_edit_tile.dart—SettingsNumberEditTile<T extends num>— numeric stepper/edit field.settings_password_edit_tile.dart—SettingsPasswordEditTile— password-style masked text field.settings_secret_edit_tile.dart—SettingsSecretEditTile— button openingUpdateSecretDialogto set a secure-storage secret.settings_text_display_tile.dart—SettingsTextDisplayTile— read-only pill/badge-styled text value, built onsettings_value_chip.dart.settings_text_edit_tile.dart—SettingsTextEditTile— plain text edit field.settings_toggle_tile.dart—SettingsToggleTile— boolean on/off toggle switch.settings_tree_view_tile.dart—SettingsTreeViewTile<TValue>— multi-select tree view of items.
Standalone (no SettingsTile wrapper), used to display a read-only value, e.g. by settings_text_display_tile.dart or directly for multi-value rows like the statistics page:
settings_value_chip.dart—SettingsValueChip— read-only pill/badge-styled text value, with an optional override for its (default accent-colored) background color.
Outside the tile family (no SettingsTile wrapper), for the “quick actions” grid:
quick_action.dart—QuickAction— large icon+label outlined button.quick_toggle.dart—QuickToggle— large icon+label toggle button.
Menus / app-level widgets
Top-level lib/ widgets outside the views/ tree.
lib/views/photo_booth_screen/photo_booth.menu.dart—MomentoMenuBar— top application menu bar (File/recent projects/etc.).lib/widgetbook.dart—WidgetbookApp— root widget for the separate Widgetbook component-catalog dev tool (not part of the main app UI).
Known near-duplicates / naming overlaps
These exist on purpose but are easy to confuse — read the note before adding a new one:
PhotoBoothFilledButton/PhotoBoothOutlinedButton(generic dialog buttons) vsPhotoBoothButton(themed booth-screen action/nav button) — three different “PhotoBooth*Button” widgets, not interchangeable.ModalDialogvsPhotoBoothDialog—ModalDialogis the higher-level shell most dialogs should use;PhotoBoothDialogis the lower-level shell it wraps.FadeAndScaleTransitionvsFadeAndSlideTransition— parallel theme-selectable page-transition effects, same constructor shape.PhotoBoothTitlevsPhotoBoothSubtitle— intentional theme-driven pair, same shape.QuickActionvsQuickToggle— intentional button/toggle pair, same visual shape.MyDropRegion(settings_overlay/components/import_field.dart) has a generic/placeholder name but is specific to TOML settings import — don’t assume it’s a general-purpose drop target.CaptureCountervsTimeCounter—CaptureCountercounts down before a photo capture;TimeCountercounts elapsed time up during a video recording.PhotoCollagevsQuoteCollage—PhotoCollageis the template-driven photo collage;QuoteCollageis a fixed receipt-printer layout for the video recording flow.