Interaktive Demo und Präsentation für Conventional Commits und automatisierte Release-Tools.
Slides befinden sich im slides Ordner und zum durchklicken unter https://mischah.github.io/conventional-changelog
Dieses Mono-Repo enthält 3 fertig konfigurierte Beispiele für automatisierte Changelog-Generierung und Commit-Validierung.
conventional-changelog/
├── packages/
│ ├── slides/ # Reveal.js Präsentation
│ └── demos/
│ ├── commit-and-tag-version/ # Demo: Einfaches Tool
│ ├── release-it/ # Demo: Interaktives Tool
│ └── commitlint/ # Demo: Commit Validierung
├── package.json # Root mit npm workspaces
└── README.md # Diese Datei
📊 Slides
Reveal.js basierte Präsentation für den Webmontag.
Quick Start:
npm run dev:slidesDie Präsentation öffnet sich automatisch im Browser unter http://localhost:3000.
Demonstration des einfachsten Tools für Conventional Commits basierte Releases.
Konzept:
- Zero Configuration
- Analysiert Commit Messages und ermittelt Version automatisch
fix:→ patch (0.0.0 → 0.0.1)feat:→ minor (0.0.0 → 0.1.0)BREAKING CHANGE:→ major (0.0.0 → 1.0.0)
- Volle Kontrolle via npm scripts (kann überschrieben werden)
- Kein automatischer Push (Safety First)
Quick Start:
cd packages/demos/commit-and-tag-version
npm install
npm run release:dry # PreviewDemonstration des interaktiven Tools mit vollständiger Automatisierung.
Konzept:
- Analysiert Commits und schlägt Version vor (interaktiv wählbar)
- Interactive Prompts mit Changelog Preview
- Dual-Mode: Interaktiv & CI/CD
- Vollständige Integration (Git, GitHub, GitLab, npm, Push)
Quick Start:
cd packages/demos/release-it
npm install
npm run release:dry # PreviewDemonstration von commitlint mit Husky Git Hooks zur Commit-Validierung.
Konzept:
- Validiert Commit Messages automatisch via Git Hook
- Lehnt ungültige Commits ab (vor dem Push!)
- Erzwingt Conventional Commits Standard
- Verhindert schlechte Commits im Team
Quick Start:
cd packages/demos/commitlint
npm install
# Versuche einen ungültigen Commit - wird abgelehnt!- Node.js 24 (Active LTS) - siehe
.nvmrc - npm 10+
- Git
# Node Version aktivieren (mit nvm)
nvm use
# Alle Dependencies installieren
npm install
# Oder einzelne Workspaces
npm install --workspace=slides
npm install --workspace=demo-commit-and-tag-version
npm install --workspace=demo-release-it
npm install --workspace=demo-commitlintnpm run dev:slidesnpm run build:slidesSiehe die READMEs in den jeweiligen Demo-Packages:
Den detaillierten Ablauf für den Webmontag findest du in DEMO.md.
- Mono-Repo: npm workspaces
- Präsentation: Reveal.js + Vite
- Release Tools:
- commit-and-tag-version v12.6.0
- release-it v17.10.0
- commitlint v19.6.0
- Git Hooks: Husky v9.1.7
- Node.js: v24 (Active LTS)
MIT