rapid-build

library6.0.0jsnpmunverified

Rapid-build is a command-line interface (CLI) build system designed for rapidly developing and distributing client-side and server-side applications, particularly those utilizing Node.js, Express, and AngularJS. It provides comprehensive support for a range of technologies including CSS, Less, Sass, HTML, JavaScript (ES6, CoffeeScript, TypeScript), Angular, Karma, Jasmine, and Express, along with Bower and npm for package management. The current stable version is 6.0.0, which was released recently and focuses on dependency updates and build stability. Its key differentiators include its opinionated yet customizable directory structure, explicit separation of `src` and `dist` environments, and distinct client/server build configurations, all managed through a `rapid-build.json` file. It's tailored for full-stack JavaScript projects, streamlining development, testing, and deployment workflows.

devops web-framework testing

npm install rapid-build

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · RAPID-BUILD

rapid-build

devopsjavascriptv6.0.0

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.

CLI Invocation

✓ rapid-build <command>

✗ import rapidBuild from 'rapid-build'

rapid-build is a command-line interface (CLI) tool and is typically installed globally or run via `npx`. It is not designed for programmatic `import` or `require` as a library.

Specific Build Commands

✓ rapid-build dev:test:client

✗ node rapid-build dev:test:client

After global installation, `rapid-build` is directly executable. Using `node rapid-build` might work if the package is local, but it's not the intended global usage pattern.

Demonstrates global installation and common command-line invocations for running development, production, and testing builds for your project.

npm install rapid-build -g # Navigate to your project root (which must have a package.json) # Create a rapid-build.json file if you don't have one. # This file will define your build options. A basic structure is: # { # "common": {}, # "dev": {}, # "prod": {} # } # Run the default build in development mode rapid-build dev # Run a production build (optimizes assets) rapid-build prod # Run client-side tests in development mode rapid-build dev:test:client

rapid-build --version

Debug

Known issues

breakingUpgrading to `rapid-build` v5.0.0 introduced a massive refactor to accommodate `gulp` v4's stricter error logging and API changes. Projects using `rapid-build` with `gulp` v3 might experience build failures due to incompatibility.

fix

Review your `rapid-build.json` configuration and any custom `gulp` tasks or plugins for compatibility with `gulp` v4's API changes. Consult `gulp` v4 migration guides.

affects: >=5.0.0

breakingVersion 6.0.0 replaces `node-sass` with the `sass` package to resolve common installation failures caused by `node-sass`'s dependency on Python. Projects explicitly relying on `node-sass` features or specific `node-sass` configurations might require adjustments, though the change is largely internal.

fix

No specific action is typically required for `rapid-build` users, as the change is internal. However, if you had custom scripts or configurations directly interacting with `node-sass` internals, review them for compatibility with the new `sass` package.

affects: >=6.0.0

breakingThe update to TypeScript v3.1.3 in `rapid-build` v6.0.0 (from v2.7.2) includes significant changes and potential breaking changes within TypeScript itself. Projects utilizing TypeScript might encounter compilation errors or behavioral changes if their code is not compatible with TS 3.1.3.

fix

Review the TypeScript v3.1.3 release notes for breaking changes (e.g., changes to `tsconfig.json` options, stricter type checks, module resolution behavior) and update your TypeScript code and configuration accordingly.

affects: >=6.0.0

gotcha`rapid-build` expects a specific, opinionated directory structure (`src/client`, `src/server`, `dist/`, `package.json`, etc.). Deviations from this structure without proper configuration in `rapid-build.json` can lead to build failures or incorrect asset processing.

fix

Adhere to the documented directory structure (`src/client`, `src/server`, `dist`, `package.json`) or carefully configure `rapid-build.json`'s options (refer to the options API) to correctly map your custom paths.

affects: All versions

gotchaAll build customizations are managed via a `rapid-build.json` (or `.cson`, `.js`) file located in the project root. This file uses distinct `common`, `dev`, and `prod` sections for configuration. Misconfigurations or incorrect option placement can lead to unexpected build behavior.

fix

Carefully review the 'Customizing Your Builds' section of the documentation and the `rapid-build` options API to ensure your `rapid-build.json` is correctly structured and options are placed in the appropriate `common`, `dev`, or `prod` blocks.

affects: All versions

Errors

Common errors & fixes

npm ERR! code ELIFECYCLE npm ERR! errno 1 npm ERR! node-sass@X.Y.Z install: `node scripts/build.js`

Installation of `node-sass` failing due to its dependency on Python, often when Python is not installed or configured correctly on the system.

fix

Upgrade to `rapid-build` v6.0.0 or higher, which replaces `node-sass` with the more stable `sass` package, eliminating the Python dependency. For older versions, ensure Python 2.x or 3.x is installed and accessible in your system's PATH.

error TS2307: Cannot find module '...' or its corresponding type declarations.

TypeScript compilation failing after upgrading `rapid-build` v6.0.0 due to the underlying TypeScript version bump (from v2.7.2 to v3.1.3), which introduced stricter module resolution or type checking.

fix

Review your TypeScript code and `tsconfig.json` against the TypeScript v3.1.3 breaking changes. Ensure all necessary type declarations (`@types/pkg-name`) are installed and properly referenced in your project.

Error: Cannot find module 'rapid-build' (when attempting to run `rapid-build` command directly)

`rapid-build` was installed locally (`npm install rapid-build`) but not globally (`npm install -g rapid-build`), and the shell cannot locate the `rapid-build` executable in its PATH.

fix

Install `rapid-build` globally using `npm install rapid-build -g` or execute it locally using `npx rapid-build <command>` within your project directory.

Upgrade

Version history

6.0.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/rapid-build/rapid-build ↗

packagehttps://www.npmjs.com/package/rapid-build ↗

homepagehttps://rapid-build.io/ ↗