prf_design 1.0.8

PRF Design System - Shared widgets, theme system, and essential utilities.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.8 - 2026-08-22

Changed

• Downgraded phone_form_field from ^11.0.1 to ^10.0.18 and removed the material_ui dependency. v11 builds on the standalone material_ui package whose widgets resolve separate Material/Theme/MaterialLocalizations classes, which crashed with "No Material widget found" / "No MaterialLocalizations found" when PRFPhoneInput was rendered inside hosts providing only Flutter's widgets (e.g. showModalBottomSheet). v10 is the last major built on the framework's own Material library and needs no workarounds.

1.0.7 - 2026-08-22

Added

• PRFOpacities — shared opacity steps for tinted overlays, borders, glows and disabled content (faint, subtle, hairline, muted, glow, accent, half, prominent, high, stronger, nearOpaque), exported from the tokens barrel.

1.0.6 - 2026-08-22

Added

• Added extra tokens

1.0.3 - 2026-08-22

Added

• New layouts widget category, exported from the main widgets barrel.
• PRFTabletSplitScaffold — canonical tablet geometry for list/detail screens: centered max-width stage with a content column and side panel column separated by a hairline divider (configurable flex weights and max width).
• PRFBrandPanel — navy "Living Root" side panel used on tablet split screens, with root-motif painting behind an optionally scrollable body.
• PRFTabletHeaderRow — tablet screen header with back navigation, an ellipsizing title, an optional inline loading spinner slot, and trailing actions.

Changed

• PRFTimelineMissionCard now uses an InkWell for tap ripple feedback instead of a bare GestureDetector.
• PRFTimelineMissionCard exposes Semantics (button role, school/status label, action hint) for accessibility.
• Capacity info chip on PRFTimelineMissionCard uses colorScheme.primary.

1.0.2 - 2026-08-06

Added

• PRFAdaptive + PRFBreakpoints adaptive layer, replacing flutter_adaptive_ui.
• Unified PRFButton (primary/secondary/destructive/google variants).
• Unified PRFTextField (text/email/name/number/password/textArea types).
• PRFPdfViewer taking decoded Uint8List bytes (no network I/O in the package).
• Offline Manrope/Lato fonts declared as Flutter font assets.

Changed

• Rewritten PRFColors as the single source of truth for every hex value (brand anchors, navy/lime 10-stop palettes, grays, status, accents).
• PRFTheme now uses a hand-authored Material 3 ColorScheme per brightness; dropped PRFThemeConfig and index-flipping palettes.
• PRFTheme.light/dark accept optional colors: (PRFBaseColors, scheme derived from Material 3 tonal palettes) and colorScheme: (full override) so consuming apps can bring their own palette.
• Token values re-based on a 4px spacing grid and fixed radius scale.
• PRFMediaCarousel copy (tooltips, image error text) is now parameterized.
• PRFPhoneInput accepts a countries list (defaults to Kenya).
• Button and input widgets consolidated from per-variant folders into a single adaptive implementation.

Removed

• Dependencies: flutter_adaptive_ui, google_fonts, http.
• Widgets with no consumers: ImagePreviewPage, AnimatedStatCard, StatHighlightCard.
• Backwards-compatible wrapper widgets: PRFPrimaryButton, PRFSecondaryButton, PRFDestroyButton, PRFGoogleAuthButton, PRFTextInput, PRFEmailInput, PRFNameInput, PRFNumberInput, PRFPasswordInput, PRFTextAreaInput — use PRFButton/PRFTextField directly (see docs/migration_guide.md).
• PRFThemeConfig, PRFTextTheme.getErrorTextStyle/getSuccessTextStyle/ getWarningTextStyle/getInfoTextStyle/getCaptionTextStyle.

0.9.7 - 2026-06-06

Added

• Add support for extending the color scheme for an organisation

0.8.4 - 2026-06-23

Added

• Add PRFSchoolCard

0.8.3 - 2026-04-23

Added

• Fix bouncy scroll on list selection

0.8.2 - 2026-04-03

Added

• Update tablet designs

0.8.1 - 2026-04-03

Added

• Minor padding on the error view
• Updated usage docs

0.8.0 - 2026-03-30

Added

• Adds an optional navbar to empty states

0.7.0 - 2026-03-30

Added

• Adds PRFTimelineMissionCard

0.6.0 - 2026-03-20

Added

• Adds PRFCarouselItem
• Adds PRFMediaGrid
• Adds PRFMediaTile

0.5.0 - 2026-03-20

Added

• Adds PRFPhoneInput
• Adds PRFDomainTabSection

0.4.0 - 2026-03-12

Changed

• Breaking: PRFTheme.light and PRFTheme.dark now require an explicit scaleFactor.
• Breaking: PRFTextTheme APIs now require an explicit scaleFactor and no longer accept BuildContext.

Migration

// Before
theme: PRFTheme.light(context)
darkTheme: PRFTheme.dark(context)

// After
theme: PRFTheme.light(
	scaleFactor: DeviceHelper.getScaleFactor(context: context),
)
darkTheme: PRFTheme.dark(
	scaleFactor: DeviceHelper.getScaleFactor(context: context),
)

// Before
PRFTextTheme.getButtonTextStyle(context)
PRFTextTheme.getErrorTextStyle(context)

// After
PRFTextTheme.getButtonTextStyle(scaleFactor: 1)
PRFTextTheme.getErrorTextStyle(scaleFactor: 1)

0.3.0 - 2026-02-11

Added

• PRFSnackbar unified snackbar helper with typed variants (error, success, info, warning).
• PRFSnackbarType enum for snackbar category styling.

Changed

• Replaced PRFErrorSnackbar with PRFSnackbar for broader snackbar support beyond errors.
• Removed publish_to field from pubspec.yaml (defaults to pub.dev).
• Release workflow now triggers on push to main (when pubspec.yaml changes) and via manual dispatch.

0.2.0 - 2026-02-11

Added

• CI workflow for automated format, analysis, and test checks.
• Release workflow for automated pub.dev publishing and GitHub Releases.
• MIT License, CHANGELOG, and .gitignore.
• Package metadata: repository, homepage, issue_tracker in pubspec.yaml.

Changed

• Configured package for pub.dev distribution.

0.1.0 - 2026-02-11

Added

• Theme System: PRFTheme (light/dark), PRFColors, PRFColorPalette, PRFColorsExtension, PRFStatusExtension, PRFTextTheme with Google Fonts (Lato).
• Widgets: PRFPrimaryButton, PRFSecondaryButton, PRFDestroyButton, GoogleAuthButton, PRFEmailInput, PRFPasswordInput, PRFTextInput, FormFieldLabel, PRFCircularProgressIndicator, PRFLinearProgressIndicator, PRFEmptyView, PRFErrorView, PRFErrorSnackbar, PRFCategoryChips, ImagePreviewPage, ReplyStatusView, AnimatedStatCard, StatHighlightCard, PDFViewerPage, WrappedPageIndicator.
• Utilities: DeviceHelper, Debouncer, DateFormatter, NumberFormatter, StringFormatter.
• Models: PRFFailure, PRFErrorType, PRFErrorSeverity.