C++ Class Creator & Utilities
A lightweight VS Code extension that generates C++ class file (.hpp). It forces immediate workspace indexing by the clangd language server and uses a custom, zero-dependency compilation pipeline instead of heavy web frameworks.
Features
Class File Generation
- Generates synchronized header (
.hpp) file directly within the targeted workspace directory.
- Automatically writes standard preprocessor header guards
#pragma once.
- Generates associated attributes getters / setters.
clangd Auto-Imports
- The extension leverages clangd's symbol resolution capabilities to automatically resolve missing include headers. When adding member attributes to a new class, the tool automatically imports the required headers directly into the generated files.
Usage
- Open your C++ project folder in VS Code.
- Press
Ctrl + Alt + C (or Cmd + Alt + C on macOS) to launch the class creator wizard.
- Enter your class architecture parameters and generate your files.
The build system is designed for speed, compiling all source code into a single self-contained bundle with zero runtime dependencies:
- Bundler:
esbuild handles TypeScript compilation and module bundling.
- Styles: The Tailwind CSS CLI generates layout utilities independently into a flat asset file.
- Minification:
html-minifier-terser compresses and minifies the HTML templates at build time via a custom build script hook before they are packaged.
Development and Compilation
Prerequisites
- Node.js (v22.22 or higher)
- VS Code (1.109.0 or higher)
- clangd extension (optional) (auto import feature)
Setup
Clone the repository and install the development dependencies:
git clone git@github.com:cinqdtun/cplusplus-class-creator-utilities.git
cd cplusplus-class-creator-utilities
npm install
Installation
If you want to build and install the extension without using the VS Code Marketplace, you can bundle it locally into a .vsix file:
npm run package
Building
A custom esbuild.js script handles the entire build pipeline. Using custom plugins, it manages output directory cleanup, asset compilation, and real-time stylesheet tracking during development.
| NPM Script |
Operation |
Behavior |
npm run dev |
Development Watch |
Purges the dist/ directory, initializes the esbuild filesystem watch loop, and appends inline source maps for local debugging. |
npm run build |
Production Build |
Purges the dist/ directory, triggers the Tailwind CLI compilation, and minifies all script and template outputs. |
npm run package |
Standalone Packaging |
Triggers a production compilation pass and bundles the extension into a local .vsix distribution file. |
Extension Packaging
The packaging process uses .vscodeignore to strip out raw TypeScript sources, configuration files, and local media assets. The final .vsix bundle includes only the essential production files: the compiled output in dist/, package.json, LICENSE, and the documentation.
License
This project is distributed under the terms of the GPL-3.0 License. See LICENSE for structural details.
