Documentation

npm install @logg/react

import '@logg/react/styles.css'

import { Changelog } from '@logg/react'
import '@logg/react/styles.css'

export default function WhatsNew() {
  return <Changelog slug="my-project" maxEntries={5} />
}

<Changelog slug="my-project" theme="logg" />

<Changelog
  slug="my-project"
  renderEntry={(entry) => (
    <div key={entry.version}>
      <h3>v{entry.version} — {entry.title}</h3>
      <p>{entry.summary}</p>
    </div>
  )}
/>

import { ChangelogNotification } from '@logg/react'

<ChangelogNotification
  slug="my-project"
  position="bottom-right"
/>

import { useChangelog } from '@logg/react'

function MyChangelog() {
  const { data, error, loading } = useChangelog('my-project')

  if (loading) return <p>Loading...</p>
  if (error) return <p>Error: {error}</p>

  return (
    <div>
      <h1>{data.project.name}</h1>
      {data.changelogs.map(entry => (
        <div key={entry.version}>
          <h2>v{entry.version}</h2>
          <p>{entry.title}</p>
          {entry.categories?.features?.map((f, i) => (
            <li key={i}>{f}</li>
          ))}
        </div>
      ))}
    </div>
  )
}

import { useLatestChangelog } from '@logg/react'

function NewVersionBanner() {
  const { data, isNew, markSeen } = useLatestChangelog('my-project')

  if (!isNew || !data) return null

  return (
    <div>
      New: v{data.version} — {data.summary}
      <button onClick={markSeen}>Dismiss</button>
    </div>
  )
}

.logg-root {
  --logg-accent: #f3f3f3;
  --logg-accent-text: #f3f3f3;
  --logg-border: rgba(255, 255, 255, 0.08);
  --logg-text: rgba(255, 255, 255, 0.9);
  --logg-text-muted: rgba(255, 255, 255, 0.4);
}

curl https://www.logg.sh/api/v1/changelogs/my-project

{
  "project": {
    "name": "My Project",
    "slug": "my-project",
    "description": "An awesome project",
    "repo": "owner/my-project"
  },
  "changelogs": [
    {
      "version": "1.2.0",
      "title": "Dark mode and performance improvements",
      "summary": "Added dark mode support and improved load times by 40%",
      "content": "## New Features\n- Dark mode support...",
      "contentHtml": "<h2>New Features</h2><ul><li>Dark mode support...</li></ul>",
      "categories": {
        "features": [
          "Dark mode with system preference detection",
          "Keyboard shortcuts for common actions"
        ],
        "improvements": [
          "Reduced bundle size by 40%",
          "Faster page transitions"
        ],
        "fixes": [
          "Fixed auth redirect loop on Safari"
        ]
      },
      "publishedAt": "2026-02-10T12:00:00.000Z",
      "releaseDate": "2026-02-10T12:00:00.000Z"
    }
  ]
}

curl https://www.logg.sh/api/v1/changelogs/my-project/latest

{
  "version": "1.2.0",
  "title": "Dark mode and performance improvements",
  "summary": "Added dark mode support and improved load times by 40%",
  "publishedAt": "2026-02-10T12:00:00.000Z",
  "releaseDate": "2026-02-10T12:00:00.000Z"
}

<iframe
  src="https://www.logg.sh/my-project/embed"
  width="100%"
  height="600"
  frameborder="0"
  style="border: none;"
></iframe>

<script>
  window.addEventListener('message', (e) => {
    if (e.data?.type === 'logg-sh-resize') {
      document.querySelector('iframe').style.height = e.data.height + 'px'
    }
  })
</script>

npm install -g @logg/cli

npx @logg/cli <command>

logg login      # opens browser for GitHub OAuth
logg whoami     # show current user and token expiry
logg logout     # clear stored credentials

# List all projects
logg project list

# Create a manual project
logg project create --name="My App" --slug=my-app

# Create a project linked to GitHub
logg project create --name="My App" --slug=my-app --github=owner/repo

# List changelogs
logg changelog list --project=my-app

# Add a changelog with inline content
logg add --project=my-app --version=1.2.3 --content="## Changes\n- Fixed bug"

# Add from a file
logg add --project=my-app --version=1.2.3 --file=CHANGELOG.md

# Publish / unpublish
logg publish --project=my-app --version=1.2.3
logg unpublish --project=my-app --version=1.2.3

# Sync releases and generate changelogs with AI
logg sync --project=my-app

# Regenerate AI content for a specific version
logg generate --project=my-app --version=1.2.3

# Cut the open commit window into an entry (commit detection mode)
logg cut --project=my-app

{
  "mcpServers": {
    "logg": {
      "url": "https://www.logg.sh/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "logg": {
      "url": "https://www.logg.sh/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "logg": {
      "url": "https://www.logg.sh/api/mcp"
    }
  }
}

Use logg to list my projects, then list changelogs for "my-project"
and publish any that are still in draft.