Shows the banner of TODO NUKEM, with its logo

TODO NUKEM - Coding Comments Generator

Working Draft

A VS Code extension for generating structured TODO comments with emojis following the TODO NUKEM Convention. Combines both interactive command-based generation and quick snippets for maximum flexibility.

📰 Installation

Install this extension from the VSCode Marketplace

🚀 Usage

This extension offers two ways to create TODO NUKEM comments:

1. 🎯 Interactive Command (Recommended)

Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P) and search for:

TODO NUKEM Comment

Follow the guided prompts:

Priority: 🟩 Low / 🔶 Medium / 🔴 High
Type: ✨ Feature / 🐛 Fix
Context: 🎨 Design / 📚 Doc / 🧪 Test / ⚡ Perf / etc.
Message: Your TODO description
Meta Blocks (optional): 💬 TBD / 🎯 Scope / 🎫 Ticket / 📅 Until / etc.

Example output:

// TODO: 🔴 ✨ 🎨 Refactor button component [🎫 JIRA-123] [📅 2025-12-31]

2. ⚡ Quick Snippets

In supported languages, type todo or fixme and press Tab to activate snippet templates:

todo ⇥ fixme ⇥

This provides pre-defined templates for quick TODO insertion.

✨ Supported Languages

Defined in the package.json file, the following languages are supported with either line or block comments:

Line Comment

TypeScript, JavaScript

Block Comment

CSS, PostCSS, SCSS, Less, HTML, Python, Java, C#, C++, Ruby, Swift, PHP, Go, Rust, Dart, Perl, Lua, Shell Script

For example, CSS uses block comments like /* ... */.

And TypeScript could use line comments like // ....

If a language you need is missing, feel free to open a PR and contribute!

❓FAQ

How can I enable snippet suggestions in comments in VSCode?

By default, snippet suggestions are not active in comments in VSCode. If you want to enable this feature, you need to adjust your settings.

In User Settings search for quickSuggestions and enable the following options:

"editor.quickSuggestions": {
    "comments": true,
    "strings": true
}

For more questions and answers, please visit our Q&A Discussions.

ESLint Plugin

For best results, combine this extension with the TODO NUKEM ESLint plugin to enforce the convention in your codebase:

The ESLint plugin validates that your TODO comments follow the TODO NUKEM Convention and can auto-fix formatting issues.

npm install --save-dev @jolution/eslint-plugin-todo-nukem

Learn more:
GitHub Repository
npm Package

❤️ Support

If you find this project helpful, please consider giving it the Convention Repo a star on GitHub.

We do not currently offer direct support for this project.

Atos

We appreciate the support from Atos, helping us continue our open source work.

✍️ Authors (in alphabetical order)

⚖️ License

See the LICENSE file for details.

ℹ️ Disclaimer

Please 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.

✨ Contributors

Thanks goes to these wonderful people (emoji key):

_{Jochen Simon}
🎨

_{Julian Kasimir}
🤔 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

TODO NUKEM Generator

jolution