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",[],[118,136],"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",[],[118,68],"f7402cbe-3100-11f0-9f15-569c3dd06744","backend","fd920574-a66a-4aa6-a24e-b0e9c65549d0",9,["D",1747254066629],[156,157,158],[150],{"_36":175,"_13":68,"_39":176,"_41":151,"_43":44,"_45":177,"_47":48,"_49":178,"_17":51,"_52":24,"_54":179,"_56":57,"_58":-5,"_92":180,"_18":181},{"_36":168,"_13":169,"_39":170,"_41":151,"_43":44,"_45":152,"_47":48,"_49":171,"_17":51,"_52":53,"_54":172,"_56":57,"_58":-5,"_92":173,"_18":174},{"_36":159,"_13":160,"_39":161,"_41":151,"_43":44,"_45":162,"_47":48,"_49":163,"_17":164,"_52":89,"_54":165,"_56":57,"_58":-5,"_92":166,"_18":167},"20a4b8cc-3101-11f0-b4cb-569c3dd06744","index.ts","003c6cf6-3101-11f0-b382-569c3dd06744",13,["D",1747254136079],1,"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;",[],[150,160],"f7401c92-3100-11f0-9f15-569c3dd06744","github.ts","f7401d5a-3100-11f0-9f15-569c3dd06744",["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}",[],[150,169],"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",[],[150,68],"665a864a-3100-11f0-8eb3-569c3dd06744",["D",1747253823541],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","userId","c156eb0e-8b9d-4104-a055-502e9a0eb441","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","orgId","2019e55b-c541-4c51-bef0-008eef10ef88","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_234":230},"org",{"_11":12,"_228":-5,"_229":230,"_191":192,"_231":232,"_233":57},"branch",{"_17":70,"_13":16,"_36":44,"_220":182,"_221":-5,"_222":-5,"_223":-5,"_224":-5,"_225":-5,"_226":14,"_227":12},"isOwned","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJ4cFpFME5pSXNZamJNd296dlZSYVJ0OVF1RSJ9","tier","pro","canRestrictVals","profileImageUrl","adoptOrgId",{"_36":182,"_13":14,"_49":312,"_184":-5,"_185":57,"_186":187,"_188":187,"_189":-5,"_190":-5,"_191":192,"_193":161,"_194":48,"_195":48,"_196":-5,"_197":51,"_198":199,"_200":-5,"_201":-5,"_202":-5,"_203":-5,"_204":205,"_206":205,"_207":208,"_209":208,"_210":208,"_211":205,"_212":205,"_213":313,"_215":314,"_217":315,"_219":57},[270,274,278,282,283],"files",[270,271,272,273,274,275,276,277,278,279,280,281,282,283],"counts",{"_261":51,"_262":164,"_263":51,"_32":264,"_265":266},[255,256,257],{"_36":74,"_13":19,"_39":42,"_41":-5,"_43":44,"_45":63,"_47":48,"_49":75,"_17":51,"_52":76,"_54":-5,"_56":57,"_58":-5,"_18":254},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},[19],{"_36":67,"_13":68,"_39":69,"_41":42,"_43":44,"_45":70,"_47":48,"_49":71,"_17":51,"_52":24,"_54":72,"_56":57,"_58":-5,"_18":260},{"_36":60,"_13":61,"_39":62,"_41":42,"_43":44,"_45":63,"_47":48,"_49":64,"_17":51,"_52":53,"_54":65,"_56":57,"_58":-5,"_18":259},{"_36":37,"_13":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_17":51,"_52":53,"_54":55,"_56":57,"_58":-5,"_18":258},[19,38],[19,61],[19,68],"pulls","branches","forks",{"_267":51,"_269":51},"connections",{"_267":51,"_268":51},"count","unfilledCount","emptyCount",{"_36":149,"_13":150,"_39":151,"_41":-5,"_43":44,"_45":152,"_47":48,"_49":153,"_17":51,"_52":76,"_54":-5,"_56":57,"_58":-5,"_92":310,"_18":311},{"_36":175,"_13":68,"_39":176,"_41":151,"_43":44,"_45":177,"_47":48,"_49":178,"_17":51,"_52":24,"_54":179,"_56":57,"_58":-5,"_92":308,"_18":309},{"_36":168,"_13":169,"_39":170,"_41":151,"_43":44,"_45":152,"_47":48,"_49":171,"_17":51,"_52":53,"_54":172,"_56":57,"_58":-5,"_92":306,"_18":307},{"_36":159,"_13":160,"_39":161,"_41":151,"_43":44,"_45":162,"_47":48,"_49":163,"_17":164,"_52":89,"_54":165,"_56":57,"_58":-5,"_92":304,"_18":305},{"_36":117,"_13":118,"_39":119,"_41":-5,"_43":44,"_45":120,"_47":48,"_49":121,"_17":51,"_52":76,"_54":-5,"_56":57,"_58":-5,"_92":302,"_18":303},{"_36":142,"_13":68,"_39":143,"_41":119,"_43":44,"_45":144,"_47":48,"_49":145,"_17":51,"_52":24,"_54":146,"_56":57,"_58":-5,"_92":300,"_18":301},{"_36":135,"_13":136,"_39":137,"_41":119,"_43":44,"_45":120,"_47":48,"_49":138,"_17":51,"_52":24,"_54":139,"_56":57,"_58":-5,"_92":298,"_18":299},{"_36":127,"_13":128,"_39":129,"_41":119,"_43":44,"_45":130,"_47":48,"_49":131,"_17":51,"_52":53,"_54":132,"_56":57,"_58":-5,"_92":296,"_18":297},{"_36":74,"_13":19,"_39":42,"_41":-5,"_43":44,"_45":63,"_47":48,"_49":102,"_17":51,"_52":76,"_54":-5,"_56":57,"_58":-5,"_92":294,"_18":295},{"_36":67,"_13":68,"_39":69,"_41":42,"_43":44,"_45":70,"_47":48,"_49":114,"_17":51,"_52":24,"_54":72,"_56":57,"_58":-5,"_92":292,"_18":293},{"_36":60,"_13":61,"_39":62,"_41":42,"_43":44,"_45":63,"_47":48,"_49":111,"_17":51,"_52":53,"_54":65,"_56":57,"_58":-5,"_92":290,"_18":291},{"_36":37,"_13":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":108,"_17":51,"_52":53,"_54":55,"_56":57,"_58":-5,"_92":288,"_18":289},{"_36":95,"_13":68,"_39":96,"_41":-5,"_43":44,"_45":97,"_47":48,"_49":98,"_17":51,"_52":24,"_54":99,"_56":57,"_58":-5,"_92":286,"_18":287},{"_36":83,"_13":84,"_39":85,"_41":-5,"_43":44,"_45":86,"_47":48,"_49":87,"_17":88,"_52":89,"_54":90,"_56":57,"_58":91,"_92":284,"_18":285},[],[84],[],[68],[],[19,38],[],[19,61],[],[19,68],[279,280,281],[19],[],[118,128],[],[118,136],[],[118,68],[275,276,277],[118],[],[150,160],[],[150,169],[],[150,68],[271,272,273],[150],["D",1747253823541],{"_11":12,"_234":230},{"_11":12,"_228":-5,"_229":230,"_191":192,"_231":232,"_233":57},{"_17":70,"_13":16,"_36":44,"_220":182,"_221":-5,"_222":-5,"_223":-5,"_224":-5,"_225":-5,"_226":14,"_227":12},"ctx",{"_213":-5,"_251":349,"_350":351,"_352":353,"_354":57,"_355":57,"_356":57,"_357":48,"_358":-5,"_359":-7,"_360":-7,"_361":51,"_362":57,"_363":57,"_364":-5,"_365":57,"_366":57,"_367":57,"_368":-5},"ENV",{"_320":321,"_322":323,"_324":16,"_325":326,"_327":328,"_329":330,"_331":332,"_333":334,"_335":336,"_337":338,"_339":340,"_341":342,"_343":344,"_345":346,"_347":348},"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"]