changelog

README

go-changelog

go-changelog renders release sections from a CHANGELOG.md and provides a ready-to-use Bootstrap 5 display with a version link, new-release badge, modal, and localStorage reminder.

Installation

go get github.com/realholgi/go-changelog

Usage

package main

import (
	_ "embed"

	"github.com/realholgi/go-changelog"
)

//go:embed CHANGELOG.md
var changelogMarkdown string

var version = "dev"

func main() {
	content := changelog.Prepare(changelogMarkdown, version)
	// Pass Content to html/template as part of the template data.
	_ = content
}

Place the trigger and modal where the application needs them:

<nav>
  {{.Changelog.Trigger}}
</nav>

<script src="/static/bootstrap.bundle.min.js"></script>
{{.Changelog.Modal}}

The embedding application must load Bootstrap 5.

Customize the display with options:

content := changelog.PrepareWithOptions(markdown, version, changelog.Options{
	ModalID:    "releaseNotes",
	StorageKey: "my_app_changelog_seen",
	Title:      "Release notes",
	NewIn:      "New in",
	Close:      "Close",
	Confirm:    "Got it",
})

Release headings must use this format:

## [Unreleased]

## [1.2.0] - 2026-07-24

Content.HTML contains every non-empty release section. Content.Date contains the date of the current version when that version exists in the changelog.

License

MIT

Documentation

Overview

Package changelog prepares a Keep a Changelog-style Markdown document for a reusable Bootstrap display.

Index

• type Content
  • func Prepare(markdown, currentVersion string) Content
  • func PrepareWithOptions(markdown, currentVersion string, options Options) Content
  • func (c Content) Modal() template.HTML
  • func (c Content) Trigger() template.HTML
• type Options

Types

type Content

type Content struct {
	HTML string
	Date string
	// contains filtered or unexported fields
}

Content contains the rendered changelog and the current release date.

func Prepare

func Prepare(markdown, currentVersion string) Content

Prepare renders every non-empty release section with the default options.

func PrepareWithOptions

func PrepareWithOptions(markdown, currentVersion string, options Options) Content

PrepareWithOptions renders every non-empty release section in source order and configures the display.

func (Content) Modal

func (c Content) Modal() template.HTML

Modal renders the styles, Bootstrap modal, and localStorage behavior. The embedding application must load Bootstrap 5.

func (Content) Trigger

func (c Content) Trigger() template.HTML

Trigger renders the version display and, when changelog content is available, the trigger and badge for the Bootstrap modal.

type Options

type Options struct {
	ModalID    string
	StorageKey string
	Title      string
	NewIn      string
	Close      string
	Confirm    string
}

Options customizes display IDs, browser storage, and labels. Empty fields are replaced by English defaults.