Registry / web-framework / reset-framework-cli

reset-framework-cli

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-framework devops

npm install reset-framework-cli

package ↗homepage ↗

INSTALL

IMPORT

SIG · RESET-FRAMEWORK-CL

reset-framework-cli

web-frameworkjavascriptv1.2.5

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

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 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

reset-framework-cli

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

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

bin

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

✗ Assuming the CLI is importable as a module

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

create-app

✓ reset-framework-cli create-app my-app

✗ reset-framework-cli new my-app

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

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 issues

breakingNode.js version must be >=20.19.0. Running with an older version will fail with engine validation error.

fix

Update Node.js to version 20.19.0 or later.

affects: <20.19.0

gotchaSource build requires CMake, Ninja, Git, and a native compiler toolchain. Missing any will cause cryptic build errors.

fix

Install CMake (>=3.15), Ninja, Git, and a C++ compiler (e.g., GCC, Clang, MSVC).

affects: >=1.0

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.

fix

Use the CLI via npx or global install, or invoke the binary from child process.

affects: >=1.0

gotchaFirst source build bootstraps vcpkg into ~/.reset-framework-cli/vcpkg, which downloads and compiles dependencies. This can take significant time and disk space.

fix

Ensure at least 5GB free space and a stable internet connection. Consider using an existing vcpkg toolchain if available.

affects: >=1.0

gotchaRuntime packages are platform-specific. The CLI will fail if no bundled runtime package exists for the current OS/architecture.

fix

Ensure @reset-framework/runtime-* package for your platform is installed. Use --runtime-source to compile from source if no bundled runtime is available.

affects: >=1.0

breakingThe CLI must be published after @reset-framework/schema, @reset-framework/backend, and @reset-framework/sdk. Installing a mismatched version can cause runtime errors.

fix

Align versions with the core framework release. Check peer dependencies or publish order documentation.

affects: >=1.0

Errors

Common errors & fixes

Error: Cannot find module '@reset-framework/schema'

The CLI requires the schema package to be installed as a dependency or globally.

fix

Install the missing package: npm install @reset-framework/schema or ensure it's in the project's node_modules.

Error: reset-framework-cli: command not found

The CLI is not installed or not in PATH.

fix

Install globally: npm install -g reset-framework-cli. Alternatively, use npx reset-framework-cli.

node: --experimental-loader is experimental. (Use `node --experimental-loader ...`)

The CLI uses experimental loaders; this warning is non-fatal but may cause issues on older Node versions.

fix

Update Node.js to >=20.19.0. Suppress with NODE_NO_WARNINGS=1 if desired.

Upgrade

Version history

1.2.5latest on npm

Audit

Dependencies

@reset-framework/schemarequiredSchema package is required for config validation and must be published before the CLI.

@reset-framework/backendrequiredBackend package provides runtime server logic; must be published before the CLI.

@reset-framework/sdkrequiredSDK package provides frontend bridge; must be published before the CLI.

@reset-framework/nativeoptionalRequired for source builds (--runtime-source); includes CMake-based runtime source.

Agent activity

6 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/reset-framework-cli ↗

homepagehttps://reset-framework.com ↗