GitHub Release Notes Generator

Generate structured release notes from your GitHub commits

\n \n

Generating release notes...

\n \n

Release Notes Preview

\n \n \n

\n\n",[],[250,252],"2f7f4e66-3101-11f0-b21c-569c3dd06744","2f7f5190-3101-11f0-b21c-569c3dd06744",15,["D",1747254161002],"# Frontend\n\nThis directory contains the client-side code for the GitHub Release Notes Generator.\n\n## Files\n\n- `index.html` - Main HTML template\n- `index.js` - JavaScript for the web interface\n\n## Features\n\n- Form for entering repository details and commit range\n- Preview of generated release notes in Markdown format\n- Copy to clipboard functionality\n- Download as Markdown file\n- Error handling and loading states\n\n## Dependencies\n\n- [Twind](https://twind.dev/) - Tailwind-in-JS for styling\n- [Marked](https://marked.js.org/) - Markdown parser and compiler",[],[250,91],"121ad2b4-3101-11f0-9039-569c3dd06744",["D",1747254111689],[201,202,203],[250],"20a4b8cc-3101-11f0-b4cb-569c3dd06744","index.ts","fd920574-a66a-4aa6-a24e-b0e9c65549d0",13,["D",1747254136079],"import { Hono } from 'https://esm.sh/hono@3.11.7';\nimport { cors } from 'https://esm.sh/hono@3.11.7/cors';\nimport { serveFile, readFile } from 'https://esm.town/v/std/utils@85-main/index.ts';\nimport { ReleaseNotesRequest, ReleaseNotesResponse } from '../shared/types';\nimport { formatDate, generateMarkdown, groupCommitsByType } from '../shared/utils';\nimport { GitHubClient } from './github';\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Enable CORS\napp.use('*', cors());\n\n// Serve static files\napp.get('/frontend/*', c => serveFile(c.req.path, import.meta.url));\napp.get('/shared/*', c => serveFile(c.req.path, import.meta.url));\n\n// Main page\napp.get('/', async c => {\n let html = await readFile('/frontend/index.html', import.meta.url);\n return c.html(html);\n});\n\n// API endpoint to generate release notes\napp.post('/api/release-notes', async c => {\n try {\n const data = await c.req.json();\n const { owner, repo, from, to = 'HEAD', format = 'conventional' } = data;\n \n // Validate input\n if (!owner || !repo || !from) {\n return c.json({ error: 'Missing required parameters' }, 400);\n }\n \n // Initialize GitHub client\n const github = new GitHubClient();\n \n // Fetch commits\n const commits = await github.getCommits(owner, repo, from, to);\n \n if (commits.length === 0) {\n return c.json({ error: 'No commits found in the specified range' }, 404);\n }\n \n // Group commits by type\n const sections = groupCommitsByType(commits);\n \n // Generate title\n const title = `Release Notes: ${owner}/${repo}`;\n const date = formatDate(new Date());\n \n // Generate markdown\n const rawMarkdown = generateMarkdown(title, date, sections);\n \n const response: ReleaseNotesResponse = {\n title,\n date,\n sections,\n rawMarkdown\n };\n \n return c.json(response);\n } catch (error) {\n console.error('Error generating release notes:', error);\n return c.json({ error: error.message }, 500);\n }\n});\n\n// Export the Hono app\nexport default app.fetch;",[],[278,271],"backend","f7401c92-3100-11f0-9f15-569c3dd06744","github.ts","f7401d5a-3100-11f0-9f15-569c3dd06744",9,["D",1747254066629],"import { GitHubCommit } from '../shared/types';\n\n// GitHub API client\nexport class GitHubClient {\n private baseUrl = 'https://api.github.com';\n private token: string;\n \n constructor() {\n const token = Deno.env.get('GITHUB_TOKEN');\n if (!token) {\n throw new Error('GITHUB_TOKEN environment variable is not set');\n }\n this.token = token;\n }\n \n private async request(path: string, options: RequestInit = {}): Promise {\n const url = `${this.baseUrl}${path}`;\n const headers = {\n 'Authorization': `token ${this.token}`,\n 'Accept': 'application/vnd.github.v3+json',\n ...options.headers\n };\n \n const response = await fetch(url, {\n ...options,\n headers\n });\n \n if (!response.ok) {\n const error = await response.text();\n throw new Error(`GitHub API error (${response.status}): ${error}`);\n }\n \n return response.json() as Promise;\n }\n \n // Get commits between two references (tags, commits, or dates)\n async getCommits(owner: string, repo: string, from: string, to: string = ''): Promise {\n let path = `/repos/${owner}/${repo}/commits?`;\n \n // Handle date format (YYYY-MM-DD)\n const datePattern = /^\\d{4}-\\d{2}-\\d{2}$/;\n \n if (datePattern.test(from)) {\n path += `since=${from}T00:00:00Z&`;\n }\n \n if (to && datePattern.test(to)) {\n path += `until=${to}T23:59:59Z&`;\n } else if (to) {\n // If 'to' is specified and not a date, use it as a reference\n path += `sha=${to}&`;\n }\n \n // If 'from' is not a date, we need to get all commits and filter\n const commits = await this.request(path);\n \n // If 'from' is a commit hash or tag, filter commits after it\n if (!datePattern.test(from)) {\n const fromCommitIndex = commits.findIndex(c => c.sha.startsWith(from));\n if (fromCommitIndex !== -1) {\n return commits.slice(0, fromCommitIndex);\n }\n }\n \n return commits;\n }\n \n // Get a specific tag reference\n async getTag(owner: string, repo: string, tag: string): Promise {\n try {\n const reference = await this.request<{ object: { sha: string } }>(`/repos/${owner}/${repo}/git/refs/tags/${tag}`);\n return reference.object.sha;\n } catch (error) {\n throw new Error(`Tag ${tag} not found: ${error.message}`);\n }\n }\n}",[],[278,280],"26de8ae2-3101-11f0-a307-569c3dd06744","26de8b8c-3101-11f0-a307-569c3dd06744",14,["D",1747254146528],"# Backend\n\nThis directory contains the server-side code for the GitHub Release Notes Generator.\n\n## Files\n\n- `index.ts` - Main entry point for the HTTP API (Hono app)\n- `github.ts` - GitHub API client for fetching repository data\n\n## API Endpoints\n\n### POST /api/release-notes\n\nGenerates release notes based on GitHub commits.\n\n**Request Body:**\n\n```json\n{\n \"owner\": \"string\", // GitHub repository owner\n \"repo\": \"string\", // GitHub repository name\n \"from\": \"string\", // Starting point (tag, commit hash, or date)\n \"to\": \"string\", // (Optional) Ending point (defaults to HEAD)\n \"format\": \"string\" // (Optional) Commit format (conventional or simple)\n}\n```\n\n**Response:**\n\n```json\n{\n \"title\": \"string\", // Release notes title\n \"date\": \"string\", // Generation date\n \"sections\": [ // Categorized sections\n {\n \"title\": \"string\", // Section title (e.g., \"Features\", \"Bug Fixes\")\n \"items\": [ // Items in this section\n {\n \"message\": \"string\", // Commit message\n \"author\": \"string\", // Author name or username\n \"sha\": \"string\", // Commit SHA\n \"url\": \"string\" // Commit URL\n }\n ]\n }\n ],\n \"rawMarkdown\": \"string\" // Formatted markdown content\n}\n```\n\n## Environment Variables\n\n- `GITHUB_TOKEN` - GitHub Personal Access Token with `repo` scope",[],[278,91],"f7402cbe-3100-11f0-9f15-569c3dd06744",["D",1747254066629],[197,198,199],[278],["D",1747253823541],{"_11":12,"_141":72},{"_11":12,"_137":-5,"_71":72,"_31":70,"_138":139,"_140":30},{"_41":84,"_13":16,"_35":38,"_129":95,"_130":-5,"_131":-5,"_132":-5,"_133":-5,"_134":-5,"_135":14,"_136":12},"ctx",{"_54":-5,"_160":335,"_336":337,"_338":339,"_340":30,"_341":30,"_342":30,"_343":24,"_344":-5,"_345":-7,"_346":-7,"_347":26,"_348":30,"_349":30,"_350":-5,"_351":30,"_352":30,"_353":30,"_354":-5},"ENV",{"_306":307,"_308":309,"_310":16,"_311":312,"_313":314,"_315":316,"_317":318,"_319":320,"_321":322,"_323":324,"_325":326,"_327":328,"_329":330,"_331":332,"_333":334},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","a3e067d4463eea85f6334f8e583e8516ae58c4f6","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · shared