hyena

Instant code health check for React & React Native projects.

30 rules. Zero config. Just run it.

Quick Start

npx hyena-studio

That's it. Hyena scans your project, shows a terminal summary, and opens a browser dashboard with detailed findings.

What It Checks

| Category | Rules | Examples | |---|---|---| | Architecture | 5 | Large components, deep nesting, prop drilling, god components, barrel bloat | | Design | 5 | Hardcoded colors, magic numbers, spacing inconsistency, duplicate styles, border radius | | Accessibility | 5 | Missing labels, small touch targets, color contrast, missing alt text, missing roles | | Performance | 5 | Inline styles, unused imports, anonymous functions in JSX, unvirtualized lists, expensive rerenders | | Best Practices | 10 | Console logs, empty catch blocks, missing error boundaries, TODO comments, useEffect without deps |

CLI Options

npx hyena-studio                      # scan + open dashboard
npx hyena-studio --ci                 # CI mode (exit code 1 if score < 70)
npx hyena-studio --ci --threshold 80  # custom threshold
npx hyena-studio --no-dashboard       # terminal only
npx hyena-studio --no-report          # skip writing report file
npx hyena-studio --json               # raw JSON output
npx hyena-studio --verbose            # show all findings in terminal

Scoring

Each category is scored 0-100. Penalties: critical = -10, warning = -3, info = -1.

Overall score is a weighted average:

• Accessibility: 25%
• Architecture: 20%
• Design: 20%
• Performance: 20%
• Best Practices: 15%

CI/CD Integration

# GitHub Actions
- name: Code Health Check
  run: npx hyena-studio --ci --threshold 75

Scan History

Hyena tracks your scores over time in .hyena/history.json. Each scan shows the delta from your last run.

Links

• Website
• GitHub

License

MIT