Skip to content

Commit 4a81dd6

Browse files
killerappclaude
andcommitted
feat: Add changelog best practices and semver resources to Release History
- Enhanced Release History modal with educational content - Added changelog best practices section with links to standards - Added comprehensive semver tools and libraries section - Included links to Keep a Changelog, Conventional Commits, and semver.org - Added language-specific semver libraries (JS, Python, Go, Rust, Java) - Included awesome lists and helper tools - Updated branding with Agentic Insights favicon and assets - All external links open in new tabs with hover effects 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
1 parent 407c0e9 commit 4a81dd6

13 files changed

+62
-1
lines changed

.claude/settings.local.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,8 @@
1111
"Bash(git add:*)",
1212
"Bash(npx wrangler pages deployment list:*)",
1313
"Bash(npx wrangler pages deploy:*)",
14-
"Bash(gh secret set:*)"
14+
"Bash(gh secret set:*)",
15+
"Bash(start http://localhost:30020)"
1516
],
1617
"deny": [],
1718
"ask": []

app/SemverVisualizerModern.tsx

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1239,11 +1239,71 @@ const SemverVisualizerModern: React.FC = () => {
12391239
</DialogDescription>
12401240
</DialogHeader>
12411241

1242+
{/* Changelog Best Practices Section */}
1243+
<div className="mt-4 p-4 bg-[#16162a] border border-gray-800 rounded-lg">
1244+
<h3 className="text-sm font-semibold text-emerald-400 mb-3">📋 Changelog Best Practices</h3>
1245+
<div className="grid grid-cols-1 md:grid-cols-2 gap-4 text-sm">
1246+
<div>
1247+
<h4 className="font-medium text-violet-400 mb-2">Standards & Conventions</h4>
1248+
<ul className="space-y-1 text-gray-400">
1249+
<li><a href="https://keepachangelog.com" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Keep a Changelog</a> - Standard format</li>
1250+
<li><a href="https://www.conventionalcommits.org" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Conventional Commits</a> - Commit message convention</li>
1251+
<li><a href="https://semver.org" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Semantic Versioning 2.0.0</a> - Version numbering rules</li>
1252+
<li><a href="https://calver.org" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Calendar Versioning</a> - Date-based versioning</li>
1253+
</ul>
1254+
</div>
1255+
<div>
1256+
<h4 className="font-medium text-violet-400 mb-2">Changelog Principles</h4>
1257+
<ul className="space-y-1 text-gray-400">
1258+
<li>• Group changes by type (Added, Changed, Fixed, etc.)</li>
1259+
<li>• Keep entries for humans, not machines</li>
1260+
<li>• Link to commits, PRs, and issues</li>
1261+
<li>• Never remove or edit published releases</li>
1262+
</ul>
1263+
</div>
1264+
</div>
1265+
</div>
1266+
1267+
{/* Semver Tools & Resources Section */}
1268+
<div className="mt-4 p-4 bg-[#16162a] border border-gray-800 rounded-lg">
1269+
<h3 className="text-sm font-semibold text-emerald-400 mb-3">🚀 Semver Tools & Libraries</h3>
1270+
<div className="grid grid-cols-1 md:grid-cols-3 gap-4 text-sm">
1271+
<div>
1272+
<h4 className="font-medium text-violet-400 mb-2">JavaScript/Node.js</h4>
1273+
<ul className="space-y-1 text-gray-400">
1274+
<li><a href="https://www.npmjs.com/package/semver" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">npm/semver</a> - Parser & comparator</li>
1275+
<li><a href="https://github.com/semantic-release/semantic-release" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">semantic-release</a> - Automated releases</li>
1276+
<li><a href="https://github.com/conventional-changelog/standard-version" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">standard-version</a> - Versioning utility</li>
1277+
<li><a href="https://github.com/lerna/lerna" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Lerna</a> - Monorepo versioning</li>
1278+
</ul>
1279+
</div>
1280+
<div>
1281+
<h4 className="font-medium text-violet-400 mb-2">Other Languages</h4>
1282+
<ul className="space-y-1 text-gray-400">
1283+
<li><a href="https://python-semantic-release.readthedocs.io" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Python Semantic Release</a></li>
1284+
<li><a href="https://github.com/Masterminds/semver" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Go Semver</a></li>
1285+
<li><a href="https://github.com/dtolnay/semver" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Rust Semver</a></li>
1286+
<li><a href="https://github.com/vdurmont/semver4j" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Semver4j</a> - Java library</li>
1287+
</ul>
1288+
</div>
1289+
<div>
1290+
<h4 className="font-medium text-violet-400 mb-2">Awesome Lists</h4>
1291+
<ul className="space-y-1 text-gray-400">
1292+
<li><a href="https://github.com/carloscuesta/gitmoji" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Gitmoji</a> - Emoji guide for commits</li>
1293+
<li><a href="https://github.com/olivierlacan/keep-a-changelog" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Keep a Changelog</a></li>
1294+
<li><a href="https://github.com/sindresorhus/awesome-nodejs#version-management" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Awesome Node.js</a> - Version tools</li>
1295+
<li><a href="https://github.com/commitizen/cz-cli" target="_blank" rel="noopener noreferrer" className="hover:text-emerald-400 underline">Commitizen</a> - Commit helper</li>
1296+
</ul>
1297+
</div>
1298+
</div>
1299+
</div>
1300+
12421301
<div className="space-y-4 mt-4">
12431302
{releases.length === 0 ? (
12441303
<div className="text-center py-12 text-muted-foreground">
12451304
<Tag className="w-12 h-12 mx-auto mb-3 opacity-30" />
12461305
<p>No releases yet</p>
1306+
<p className="text-sm mt-2">Start adding commits and create your first release!</p>
12471307
</div>
12481308
) : (
12491309
releases.map(release => (

app/favicon.ico

-19.3 KB
Binary file not shown.

public/apple-touch-icon.png

28.1 KB
Loading

public/favicon-128x128.png

15.3 KB
Loading

public/favicon-16x16.png

754 Bytes
Loading

public/favicon-192x192.png

31.6 KB
Loading

public/favicon-32x32.png

1.92 KB
Loading

public/favicon-48x48.png

3.26 KB
Loading

public/favicon-512x512.png

142 KB
Loading

0 commit comments

Comments
 (0)