{"id":37391191,"url":"https://github.com/jolution/todo-nukem-vscode","last_synced_at":"2026-01-16T05:31:58.804Z","repository":{"id":232618168,"uuid":"784717341","full_name":"jolution/todo-nukem-vscode","owner":"jolution","description":"Vscode Generator Extension for TODO NUKEM","archived":false,"fork":false,"pushed_at":"2025-12-02T12:39:21.000Z","size":705,"stargazers_count":21,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-04T10:37:39.884Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jolution.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["jolution","juliankasimir"]}},"created_at":"2024-04-10T12:18:51.000Z","updated_at":"2025-12-02T12:39:25.000Z","dependencies_parsed_at":"2024-04-23T14:03:48.200Z","dependency_job_id":"2ffd12d8-1bac-45b7-ac05-257c95e8598a","html_url":"https://github.com/jolution/todo-nukem-vscode","commit_stats":null,"previous_names":["jolution/todo-nukem-snippet-vscode","jolution/todo-nukem-vscode"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jolution/todo-nukem-vscode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolution%2Ftodo-nukem-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolution%2Ftodo-nukem-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolution%2Ftodo-nukem-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolution%2Ftodo-nukem-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jolution","download_url":"https://codeload.github.com/jolution/todo-nukem-vscode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolution%2Ftodo-nukem-vscode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28477282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T03:13:13.607Z","status":"ssl_error","status_checked_at":"2026-01-16T03:11:47.863Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-16T05:31:58.044Z","updated_at":"2026-01-16T05:31:58.798Z","avatar_url":"https://github.com/jolution.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./images/todonukem-dark.png\"\u003e\n        \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./images/todonukem-light.png\"\u003e\n        \u003cimg alt=\"Shows the banner of TODO NUKEM, with its logo\" src=\"./images/todonukem-dark.png\" width=\"700\"\u003e\n    \u003c/picture\u003e\n\u003c/p\u003e\n\n# TODO NUKEM\n\n[![The MIT License](https://img.shields.io/badge/license-MIT-orange.svg?style=flat-square)](http://opensource.org/licenses/MIT)\n[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-TODO%20NUKEM-blue.svg?colorA=24292e\u0026colorB=0366d6\u0026style=flat\u0026longCache=true\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAM6wAADOsB5dZE0gAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAERSURBVCiRhZG/SsMxFEZPfsVJ61jbxaF0cRQRcRJ9hlYn30IHN/+9iquDCOIsblIrOjqKgy5aKoJQj4O3EEtbPwhJbr6Te28CmdSKeqzeqr0YbfVIrTBKakvtOl5dtTkK+v4HfA9PEyBFCY9AGVgCBLaBp1jPAyfAJ/AAdIEG0dNAiyP7+K1qIfMdonZic6+WJoBJvQlvuwDqcXadUuqPA1NKAlexbRTAIMvMOCjTbMwl1LtI/6KWJ5Q6rT6Ht1MA58AX8Apcqqt5r2qhrgAXQC3CZ6i1+KMd9TRu3MvA3aH/fFPnBodb6oe6HM8+lYHrGdRXW8M9bMZtPXUji69lmf5Cmamq7quNLFZXD9Rq7v0Bpc1o/tp0fisAAAAASUVORK5CYII=)](https://marketplace.visualstudio.com/items?itemName=jolution.todo-nukem-vscode)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n\n**Working Draft**\n\nA VSCode extension for creating and managing structured TODO comments with emojis following the [TODO NUKEM Convention](https://github.com/jolution/todo-nukem/blob/main/README.md). Features **interactive comment generation**, **TODO overview with filtering**, and **quick snippets** for maximum productivity.\n\n\u003c!-- ### 🎬 Demo --\u003e\n\n\u003c!-- #### Generate Comment --\u003e\n\u003c!-- ![generate-demo.gif](./images/generate-demo.gif) --\u003e\n\n## 📰 Installation\n\nInstall this extension from the [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=jolution.todo-nukem-vscode)\n\n## 🚀 Usage\n\nThis extension offers **two ways** to create TODO NUKEM comments:\n\n### 1. 🎯 Interactive Command (Recommended)\n\nOpen the Command Palette (`Cmd+Shift+P` or `Ctrl+Shift+P`) and search for:\n\n```\nTODO NUKEM Comment\n```\n\nFollow the guided prompts:\n\n1. **Priority**: 🟩 Low / 🔶 Medium / 🔴 High\n2. **Type**: ✨ Feature / 🐛 Fix\n3. **Context**: 🎨 Design / 📚 Doc / 🧪 Test / ⚡ Perf / etc.\n4. **Message**: Your TODO description\n5. **Meta Blocks** (optional): 💬 TBD / 🎯 Scope / 🎫 Ticket / 📅 Until / etc.\n\n**Example in source code:**\n\n```typescript\n// TODO: [high] [feature] [design] Refactor button component [ticket: JIRA-123] [until: 2025-12-31]\n```\n\n**Visual display (with decorations):**\n\nThe extension decorates the keys with emojis in the editor:\n\n```text\n// TODO: 🔴 ✨ 🎨 Refactor button component 🎫 JIRA-123 📅 2025-12-31\n```\n\n\u003e **Note:** You can customize the display mode in `todonukem.json` (emoji, text, or emoji-text combination). Alternatively, click the **eye icon (👁️)** in the status bar to quickly toggle between display modes.\n\n### 2. ⚡ Quick Snippets\n\nIn supported languages, type `todo` or `fixme` and press `Tab` to activate snippet templates:\n\n```todo ⇥```\n```fixme ⇥```\n\nThis provides pre-defined templates for quick TODO insertion.\n\n## ✨ Supported Languages\n\n_Defined in the ```package.json``` file, the following languages are supported with either line or block comments:_\n\n### Line Comment\n\n```TypeScript, JavaScript```\n\n### Block Comment\n\n```CSS, PostCSS, SCSS, Less, HTML, Python, Java, C#, C++, Ruby, Swift, PHP, Go, Rust, Dart, Perl, Lua, Shell Script```\n\nFor example, CSS uses block comments like ```/* ... */```.\n\nAnd TypeScript could use line comments like ```// ...```.\n\n**If a language you need is missing, feel free to open a PR and contribute!**\n\n## ❓FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003eHow can I enable snippet suggestions in comments in VSCode?\u003c/summary\u003e\n\u003cp\u003eBy default, snippet suggestions are not active in comments in VSCode. If you want to enable this feature, you need to adjust your settings.\n\nIn User Settings search for `quickSuggestions` and enable the following options:\n\n```json\n\"editor.quickSuggestions\": {\n    \"comments\": true,\n    \"strings\": true\n}\n```\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eThe green emoji (🟩) doesn't display on older Windows 10 versions\u003c/summary\u003e\n\u003cp\u003eOlder Windows 10 versions don't support the green square emoji (🟩). To fix this, create a \u003ccode\u003etodonukem.json\u003c/code\u003e file in your workspace root with the following content:\n\n```json\n{\n  \"emojis\": {\n    \"priority\": {\n      \"low\": \"🔵\"\n    }\n  }\n}\n```\n\nThis replaces the green square with a blue circle (🔵).\n\nAfter creating the file, press `Ctrl+Shift+P` (or `Cmd+Shift+P` on Mac), type `reload`, and select **\"Developer: Reload Window\"** to apply the changes.\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eHow can I customize the display mode?\u003c/summary\u003e\n\u003cp\u003eYou can customize how TODOs are displayed by creating a \u003ccode\u003etodonukem.json\u003c/code\u003e file in your workspace root:\n\n**Emoji only (default):**\n\n```json\n{\n  \"displayMode\": \"emoji\"\n}\n```\n\nDisplays: `🔴 ✨ 🎨`\n\n**Text only:**\n\n```json\n{\n  \"displayMode\": \"text\"\n}\n```\n\nDisplays: `High Feature Design`\n\n**Emoji-text combination:**\n\n```json\n{\n  \"displayMode\": \"emoji-text\"\n}\n```\n\nDisplays: `🔴-high ✨-feature 🎨-design`\n\nAfter creating or modifying the file, reload the window with `Ctrl+Shift+P` → `reload` → **\"Developer: Reload Window\"**.\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eHow can I configure ticket links?\u003c/summary\u003e\n\u003cp\u003eYou can make ticket references clickable by configuring a \u003ccode\u003eticketBaseUrl\u003c/code\u003e in your \u003ccode\u003etodonukem.json\u003c/code\u003e file:\n\n```json\n{\n  \"ticketBaseUrl\": \"https://jira.example.com/browse\"\n}\n```\n\nNow when you use `[ticket: JIRA-123]` in your TODO comments, the ticket ID becomes a clickable link that opens in your browser:\n\n```typescript\n// TODO: [high] [feature] Fix login bug [ticket: JIRA-123]\n```\n\nClicking on `JIRA-123` will open `https://jira.example.com/browse/JIRA-123`.\n\nAfter creating or modifying the file, reload the window with `Ctrl+Shift+P` → `reload` → **\"Developer: Reload Window\"**.\n\n\u003c/p\u003e\n\u003c/details\u003e\n\nFor more questions and answers, please visit our [Q\u0026A Discussions](https://github.com/jolution/todo-nukem/discussions/categories/q-a).\n\n## 🔗 Related Tools\n\n### ESLint Plugin\n\nFor best results, combine this extension with the **TODO NUKEM ESLint plugin** to enforce the convention in your codebase:\n\n[![eslint-plugin-todo-nukem](https://img.shields.io/npm/v/eslint-plugin-todo-nukem?label=eslint-plugin-todo-nukem\u0026logo=eslint)](https://github.com/jolution/eslint-plugin-todo-nukem)\n\nThe ESLint plugin validates that your TODO comments follow the TODO NUKEM Convention and can auto-fix formatting issues.\n\n```bash\nnpm install --save-dev @jolution/eslint-plugin-todo-nukem\n```\n\n**Learn more:**  \n[GitHub Repository](https://github.com/jolution/eslint-plugin-todo-nukem)  \n[npm Package](https://www.npmjs.com/package/@jolution/eslint-plugin-todo-nukem)\n\n## ❤️ Support\n\nIf you find this project helpful, please consider giving it the Convention Repo a star on [GitHub](https://github.com/jolution/todo-nukem).\n\n[![Star this repository](https://img.shields.io/github/stars/jolution/todo-nukem-snippet-vscode?style=social)](https://github.com/jolution/todo-nukem)\n\nWe do not currently offer direct support for this project.\n\n## 💎 Sponsor\n\n### Atos\n\nWe appreciate the support from [Atos](https://atos.net), helping us continue our open source work.\n\n### ✍️ Authors (in alphabetical order)\n\n- [@juliankasimir](https://www.github.com/juliankasimir)\n- [@pimmok](https://www.github.com/pimmok)\n\n## ⚖️ License\n\nSee the [LICENSE](LICENSE) file for details.\n\n## ℹ️ Disclaimer\n\nPlease note that this project, TODO NUKEM, is not officially associated with or endorsed by the Duke Nukem franchise or its creators. It is an independent project developed by the open-source community and does not claim any rights to the Duke Nukem trademark or any related materials.\n\n## ✨ Contributors\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://jochensimon.com/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/17846993?v=4?s=100\" width=\"100px;\" alt=\"Jochen Simon\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJochen Simon\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#design-pimmok\" title=\"Design\"\u003e🎨\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/juliankasimir\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/120172350?v=4?s=100\" width=\"100px;\" alt=\"Julian Kasimir\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJulian Kasimir\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-juliankasimir\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/jolution/le-checkout-jira/commits?author=juliankasimir\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","funding_links":["https://github.com/sponsors/jolution","https://github.com/sponsors/juliankasimir"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolution%2Ftodo-nukem-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjolution%2Ftodo-nukem-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolution%2Ftodo-nukem-vscode/lists"}