Product Changelog

Product Changelog

Write changelogs and release notes that users read and care about via inference.sh CLI.

Quick Start

curl -fsSL https://cli.inference.sh | sh && infsh login # Generate a feature announcement visual infsh app run falai/flux-dev-lora --input '{ "prompt": "clean product UI screenshot mockup, modern dashboard interface showing a new analytics chart feature, light mode, minimal design, professional SaaS product", "width": 1248, "height": 832 }' Install note: The install script only detects your OS/architecture, downloads the matching binary from dist.inference.sh, and verifies its SHA-256 checksum. No elevated permissions or background processes. Manual install & verification available.

The Anatomy of a Good Entry

### New: Bulk Export for Reports 📊 You can now export up to 10,000 rows at once from any report view. Select your rows, click Export, and choose CSV or Excel format. Previously limited to 500 rows per export.  Structure: Category label -> User-facing title -> What you can do now -> How -> What changed -> Visual

User-Facing Language

❌ Internal language: "Implemented batch processing queue for the export service" "Refactored the ReportExporter class to support pagination" "Fixed bug in CSV serialization (PR #4521)" ✅ User-facing language: "You can now export up to 10,000 rows at once from any report" "Reports now load 3x faster when filtering large datasets" "Fixed an issue where exported CSV files had missing columns" Rules: Write what the user can DO, not what you BUILT Start with "You can now..." / "Reports now..." / "Fixed an issue where..." Include the benefit, not just the mechanism Use present tense

Standard Categories

CategoryColorIconUse ForNewGreen✨ or 🆕Entirely new features or capabilitiesImprovedBlue⚡ or 🔧Enhancements to existing featuresFixedYellow/Orange🐛 or 🔨Bug fixesRemovedRed🗑️ or ⚠️Deprecated or removed featuresSecurityPurple🔒Security patches

Categorization Rules

New = something users couldn't do before at all Improved = something users could do, now it's better/faster/easier Fixed = something that was broken, now works correctly Don't use "Updated" — it's meaningless. Was it improved or fixed?

Semantic Versioning (SemVer)

MAJOR.MINOR.PATCH 3 . 2 . 1 ComponentIncrement WhenExampleMAJORBreaking changes, major redesign2.0.0 -> 3.0.0MINORNew features, backward-compatible3.1.0 -> 3.2.0PATCHBug fixes, small improvements3.2.0 -> 3.2.1

Date-Based Versioning

2026-02-08 or 2026.02.08 or February 8, 2026 Best for SaaS products with continuous deployment.

Changelog Page Structure

• # Changelog
• ## February 8, 2026
• ### New
• **Bulk Export for Reports** — Export up to 10,000 rows at once. [Learn more →](link)
• **Dark Mode** — Toggle dark mode from Settings > Appearance.
• ### Improved
• **Dashboard Loading** — Dashboards now load 3x faster on large datasets.
• **Search** — Search results now include archived items.
• ### Fixed
• Fixed an issue where exported CSV files had missing column headers.
• Fixed a bug where the date picker showed incorrect timezone.
• ---
• ## February 1, 2026
• ### New
• **API Webhooks** — Get notified when events happen in your account.
• ### Fixed
• Fixed an issue where email notifications were delayed by up to 2 hours.

When to Add Visuals

Change TypeVisualNew UI featureScreenshot of the new featureUI redesignBefore/after comparisonNew workflowStep-by-step screenshots or short videoPerformance improvementChart showing improvementComplex featureAnimated GIF or video demo

Generating Visuals

# Feature screenshot (if you have the app running, use agent browser) infsh app run infsh/agent-browser --input '{ "url": "https://your-app.com/new-feature", "action": "screenshot" }' # Before/after comparison infsh app run infsh/stitch-images --input '{ "images": ["before-screenshot.png", "after-screenshot.png"], "direction": "horizontal" }' # Annotated screenshot with callout infsh app run bytedance/seededit-3-0-i2i --input '{ "prompt": "add a red circle highlight around the export button in the top right area", "image": "screenshot.png" }' # Feature announcement banner infsh app run falai/flux-dev-lora --input '{ "prompt": "clean modern product announcement banner, gradient blue to purple background, abstract geometric shapes, professional SaaS aesthetic, wide format", "width": 1248, "height": 832 }'

Breaking Changes

• Breaking changes need special treatment:
• ### ⚠️ Breaking: API v2 Endpoints Deprecated
• **What changed:** API v1 endpoints will stop working on March 15, 2026.
• **What you need to do:**
• 1. Update your API calls to use v2 endpoints ([migration guide →](link))
• 2. Update authentication to use Bearer tokens instead of API keys
• 3. Test your integration before March 15
• **Timeline:**
• Now: v2 endpoints available, v1 still works
• March 1: v1 returns deprecation warnings
• March 15: v1 stops working
• If you need help migrating, contact support@company.com.

Distribution Channels

ChannelFormatWhenChangelog pageFull detail, all entriesEvery releaseIn-app notification1-2 line summaryNew features, breaking changesEmailCurated highlights, visualsMajor releases (monthly/quarterly)Blog postDeep dive with contextBig launchesSocial mediaSingle feature highlightNotable featuresSlack/DiscordBrief announcementIf you have a community

Social Media Snippet Format

🆕 New in [Product]: [Feature Name] [1-2 sentence description of what you can now do] [Screenshot or demo video] Try it now → [link]

Do

Group related changes together Lead with the biggest/most requested change Link to documentation for complex features Include who requested it ("By popular request:") Show migration paths for breaking changes Date every entry

Don't

Don't say "various bug fixes" — list specific fixes or skip them Don't include internal references (PR numbers, ticket IDs, branch names) Don't use "Updated [feature]" without saying how Don't list changes nobody cares about (dependency bumps, internal refactors) Don't commit-dump — one changelog entry may represent many commits

Changelog Frequency

Product TypeFrequencyNotesSaaS (continuous deploy)Weekly batchGroup a week of changesSaaS (major features)Per feature launchWith blog postVersioned softwarePer version releaseTied to semverAPIPer version + deprecation noticesInclude migration guidesMobile appPer app store releaseMatch store listing "What's New"

Common Mistakes

MistakeProblemFixDeveloper languageUsers don't understandWrite what users can do"Bug fixes and improvements"Zero informationList specific fixesNo datesCan't tell what's newDate every entryNo visualsUsers skip textScreenshot major featuresBreaking changes buriedUsers discover too lateProminent warning + timelineCommit log as changelogNoisy, unhelpfulCurate and rewrite

Related Skills

npx skills add inference-sh/skills@ai-image-generation npx skills add inference-sh/skills@prompt-engineering Browse all apps: infsh app list