prf_design 1.0.2

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.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.