Registry / web-framework / reset-framework-cli

reset-framework-cli

JSON →
library1.2.5jsnpmunverified

The official command-line tool for building, developing, and packaging applications with Reset Framework. Current stable version is 1.2.5, with a release cadence aligned with the core framework (published after schema, backend, and SDK packages). Key differentiators: it orchestrates the full lifecycle (create, dev, build, package, doctor), optionally compiles the runtime from source via CMake/Ninja, and remains thin by delegating platform logic to separate runtime packages. Requires Node.js >=20.19.0.

web-frameworkdevops
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18226 runs
build_error
glibc
node 18226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

This is a CLI tool, not a library. Use npx or global install.

npx reset-framework-cli create-app my-app

The package exposes a binary, not a JavaScript module. Use child_process.exec or similar.

package.json: { "bin": { "reset-framework-cli": "./bin/cli.js" } }

The command is `create-app`, not `new` or `init`.

reset-framework-cli create-app my-app

Demonstrates installing the CLI globally, creating a new app, running dev server, building, packaging, and running diagnostics.

# Install globally npm install -g reset-framework-cli # Create a new project reset-framework-cli create-app my-app # Change directory and start development cd my-app reset-framework-cli dev # Build for production reset-framework-cli build # Package the desktop app reset-framework-cli package # Verify setup reset-framework-cli doctor
reset --version
Debug
Known footguns
breakingNode.js version must be >=20.19.0. Running with an older version will fail with engine validation error.
gotchaSource build requires CMake, Ninja, Git, and a native compiler toolchain. Missing any will cause cryptic build errors.
deprecatedThe CLI is not a library and should not be imported or required directly. Attempting to require('reset-framework-cli') returns an object, but no stable API is provided.
gotchaFirst source build bootstraps vcpkg into ~/.reset-framework-cli/vcpkg, which downloads and compiles dependencies. This can take significant time and disk space.
gotchaRuntime packages are platform-specific. The CLI will fail if no bundled runtime package exists for the current OS/architecture.
breakingThe CLI must be published after @reset-framework/schema, @reset-framework/backend, and @reset-framework/sdk. Installing a mismatched version can cause runtime errors.
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
10 hits · last 30 days
gptbot
4
ahrefsbot
4
script
1
bingbot
1
Resources