Registry / devops / bounce-in-style

bounce-in-style

library0.0.40jsnpmunverified

BounceInStyle is a unified style guide, formatter, and commit validator for Bounce TypeScript projects. Version 0.0.40 bundles ESLint, Prettier, commitlint, and husky configuration to enforce consistent code style, format, and commit messages with zero config. It provides a CLI tool (npx bis) to lint, format, and validate staged files, with separate configs for React and React Native projects. Notable differentiator: it replaces multiple standalone tools (ESLint, Prettier, commitlint configs) with a single dependency and simple CLI commands. It is actively maintained, though still early-stage as indicated by the version number.

devops

npm install bounce-in-style

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BOUNCE-IN-STYLE

bounce-in-style

devopsjavascriptv0.0.40

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

bis CLI

✓ npx bis --staged

✗ npx bounce-in-style

The package exposes a binary named 'bis', not 'bounce-in-style'. Always use 'npx bis'.

ESLint config

✓ extends: 'bouncedinc'

✗ extends: 'bounce-in-style'

The ESLint config is published as 'eslint-config-bouncedinc' (or with '-react' / '-react-native' suffix). Import via ESLint's extends field, not by importing the module directly.

Commitlint config

✓ npx commitlint --config ./node_modules/commitlint-config-bouncedinc/index.js

✗ npx commitlint --config commitlint-config-bouncedinc

The commitlint config is a separate package 'commitlint-config-bouncedinc' installed as a dependency of bounce-in-style. You must reference the full path to its index.js file. This is used with @commitlint/cli.

Shows the recommended install and setup process: remove old tools, install bounce-in-style and husky, add git hooks for pre-commit lint/format and commit-msg validation.

// Remove any existing ESLint, Prettier, and config files (keep .eslintignore/.prettierignore) npm uninstall eslint prettier eslint-config-* && rm -f .eslintrc* .prettierrc* // Install bounce-in-style as dev dependency npm install bounce-in-style -D // Install fresh husky (version 6+) npm uninstall husky && npm install husky -D && npx husky install // Add prepare script to package.json // "scripts": { "prepare": "husky install" } // Add pre-commit hook (for backend projects without React/React Native): npx husky add .husky/pre-commit "npx bis --staged" // Add commit-msg hook: npx husky add .husky/commit-msg "npx commitlint --edit \"$1\" --config ./node_modules/commitlint-config-bouncedinc/index.js" // Now git commit will lint/format staged files and validate commit messages

Debug

Known issues

breakingHusky v6 has major breaking changes. Ensure you uninstall any previous husky version before installing.

fix

Run 'npm uninstall husky' then 'npm install husky -D' and follow the new setup guide (npx husky install, .husky directory).

affects: >=6.0.0

deprecatedThe 'bis' CLI may not support all flags in future versions. The README lists --staged, --check, --react, --react-native but no future deprecation schedule is given.

fix

Use --help to see current flags. Check release notes before upgrading.

affects: >=0.0.0

gotchaThe package requires you to manually install peers like eslint, prettier, and commitlint. Missing peers can cause confusing errors.

fix

Ensure all peer dependencies are installed: eslint, prettier, @commitlint/cli (if using commit hooks).

affects: >=0.0.0

gotchaThe ESLint config is not automatically applied; you must set 'extends' in your ESLint config to 'bouncedinc', 'bouncedinc/react', or 'bouncedinc/react-native'. Otherwise, ESLint will not use it.

fix

Create or edit .eslintrc with 'extends': ['bouncedinc'].

affects: >=0.0.0

Errors

Common errors & fixes

npx: command bis not found

bounce-in-style not installed or not in node_modules

fix

Run 'npm install bounce-in-style -D' in the project root.

Cannot find module 'eslint-config-bouncedinc'

ESLint config not resolved because it's inside bounce-in-style/node_modules; ESLint expects it at the top level.

fix

Ensure bounce-in-style is installed (not just listed in package.json). If using yarn or pnpm, install as dev dependency and check node_modules.

Error: No configuration found for commitlint

commit-msg hook is not pointing to the correct commitlint config path.

fix

Use the exact path: --config ./node_modules/commitlint-config-bouncedinc/index.js

husky > pre-commit hook exited with code 1 (error)

bis --staged found linting errors or formatting inconsistencies.

fix

Run 'npx bis' (without --staged) to see full errors. Fix files and stage them again.

Upgrade

Version history

0.0.40latest on npm

Audit

Dependencies

huskyoptionalRequired for git hooks (pre-commit and commit-msg). The README instructs to install husky separately after removing old versions.

eslintoptionalPeer dependency since bounce-in-style provides ESLint configs but does not bundle ESLint itself.

prettieroptionalPeer dependency since bounce-in-style provides Prettier config but does not bundle Prettier.

commitlintoptionalPeer dependency for commit message validation; the CLI references commitlint-config-bouncedinc which works with @commitlint/cli.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/Bounced-Inc/bounce-in-style ↗

packagebounce-in-style ↗

homepagehttps://github.com/Bounced-Inc/bounce-in-style#readme ↗