prism_changelog 0.1.0

In-app "What's New" screens and changelog views for Flutter — parses Keep-a-Changelog markdown into version cards, tracks last-seen versions, and renders beautifully with zero dependencies.

prism_changelog

In-app "What's New" screens and changelog views for Flutter — parses Keep-a-Changelog markdown into beautiful version cards, tracks last-seen versions, and needs zero configuration.

Part of the Prism package family.

Features

• ✅ ChangelogView — version cards with date, title, bullets, and a NEW badge
• ✅ WhatsNewSheet — ready-made bottom sheet showing only what's new since the user's last visit
• ✅ Version tracking — persists the last-seen version (pluggable store)
• ✅ Parses real changelog files: ## [1.2.0] - 2026-01-15, ## 1.2.0, ### 1.2.0 (Hotfix) — numeric version comparison included (1.10 > 1.9)
• ✅ Categorized sections — ### Added / ### Fixed / ### Changed subsections render as labeled groups, proper Keep-a-Changelog style
• ✅ Asset loading — one call to load CHANGELOG.md from app assets
• ✅ Localizable labels — badge text, "Show older"/"Show fewer" fully configurable via ChangelogStyle
• ✅ Bullets keep their markdown (**bold**, links) — pair with prism_markdown via bulletBuilder for rich rendering
• ✅ Collapsible older versions
• ✅ Pure Flutter, all six platforms

Installation

dependencies:
  prism_changelog: ^0.1.0

What's New sheet (auto-popup pattern)

After an app update, show users only what changed:

await WhatsNewSheet.show(
  context,
  changelog: myChangelogMarkdown, // your CHANGELOG.md as a string
  store: const SharedPrefsSeenStore(), // default
);

First launch: shows everything. After dismissing: next launch shows only versions newer than the last-seen one.

Full history view

ChangelogView(
  changelog: myChangelogMarkdown,
  highlightVersion: currentVersion, // NEW badge
  collapsible: true, // "Show older (4)" toggle
)

Categorized changelogs

## [2.0.0] - 2026-02-01
### Added
- Dark mode
### Fixed
- Crash on cold start

Cards render Added / Fixed headers in the theme's primary color automatically — no configuration.

Load from an asset

final entries = await ChangelogParser.fromAsset('CHANGELOG.md');
ChangelogView(entries: entries);

Localize everything

const ChangelogStyle(
  badgeText: 'NOUVEAU',
  showOlderLabel: 'Versions précédentes',
  showFewerLabel: 'Réduire',
)

Rich bullets with prism_markdown

ChangelogView(
  changelog: myChangelog,
  bulletBuilder: (bullet) => PrismMarkdown(bullet),
)

The Prism package family

Package	What it does
prism_markdown	Markdown widget with full CommonMark + GFM support
prism_code_view	Syntax-highlighted code viewer (Dart/JSON/YAML built in)
prism_adaptive_scaffold	Responsive scaffolds: bottom bar → rail → extended rail
prism_adaptive_dialog	Dialogs that become bottom sheets on phones
prism_state_views	Empty, loading, error, and success states from one widget
prism_master_detail	Adaptive master-detail layouts
prism_banner	Dismissible announcement banners
prism_search	Adaptive search with suggestions
prism_toast	Adaptive toast notifications
prism_pagination	Infinite-scroll lists with all states handled
prism_form	Declarative forms with sealed submit states
prism_changelog	In-app "What's New" screens and changelog views

All pure Flutter, all six platforms, MIT licensed, built to work together.

License

MIT — see LICENSE.