imxc

library0.6.13jsnpmunverified

imxc is a compiler that transforms React-like TypeScript/JSX (.tsx) into native C++ code using Dear ImGui. Version 0.6.13 is stable; releases are on-demand. It offers a CLI for scaffolding projects, watching files, and generating code. Key differentiators include tight integration with Dear ImGui, a 5-prop theme system, support for custom C++ widgets, and TypeScript type checking via .d.ts files. It requires Node.js, CMake 3.25+, and a C++20 compiler.

devops web-framework

npm install imxc

package ↗

INSTALL

IMPORT

SIG · IMXC

imxc

devopsjavascriptv0.6.13

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Scaffolds a minimal IMX project, compiles TSX to C++, and builds the native app using CMake.

npx imxc init myapp --template=minimal && cd myapp && cmake -B build && cmake --build build --config Release

imxc --version

Debug

Known issues

gotchaCLI tool must be run via npx or installed globally. Direct 'imxc' command may not work if not in PATH.

fix

Use npx imxc or install globally with npm install -g imxc.

affects: *

breakingTypeScript 'number' props always generate C++ 'float'. Use integer types via custom declarations.

fix

Declare custom native widgets in src/imx.d.ts to specify exact C++ types.

affects: <1.0

gotchaFile structure: 'src/App.tsx' is treated as the default entrypoint; incorrect file names may break auto-detection.

fix

Name your entry file 'App.tsx' inside the 'src' folder, or specify it explicitly with --entry.

affects: *

gotchaCMake 3.25+ and C++20 compiler are required; older versions or compilers will fail.

fix

Update CMake to 3.25+ and ensure your compiler supports C++20 (e.g., GCC 11+, Clang 14+, MSVC 2022).

affects: *

Errors

Common errors & fixes

error: 'imxc' is not recognized as an internal or external command

imxc not installed globally or not in PATH.

fix

Run: npx imxc instead, or install globally: npm install -g imxc

CMake Error: cmake version 3.20 is too old; need 3.25 or later.

Incompatible CMake version.

fix

Download and install CMake 3.25 or later from https://cmake.org/download/

error: 'imx' is not a valid namespace or class

Generated C++ code may be missing header includes or wrong compilation target.

fix

Ensure you ran cmake correctly; check your CMakeLists.txt for proper IMX integration.

Upgrade

Version history

0.6.13latest on npm

Audit

Dependencies

typescriptrequiredType checking and parsing of TSX files; used at compile time.

cmakerequiredRequired to build the generated C++ code into executables.

Agent activity

6 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/imxc ↗