Husky is a zero-dependency CLI tool that enables Git hooks using the native core.hooksPath feature introduced in Git 2.9. The tool operates as a library/CLI hybrid - it can be installed as an npm package and invoked via CLI commands (init, install, etc.) or imported programmatically. The architecture is intentionally minimal: bin.js handles CLI entry points, index.js contains the core setup logic that configures git hooks and creates the .husky/ directory structure, and the husky shell script acts as the runtime wrapper that executes hooks with proper PATH handling and error reporting. The tool modifies git configuration (core.hooksPath) to point to .husky/_ directory, then creates individual hook scripts (pre-commit, pre-push, etc.) that delegate to the main husky runner. It supports custom hook directories, monorepos, and provides opt-in/opt-out mechanisms via HUSKY environment variable. The codebase demonstrates exceptional craftsmanship through its zero-dependency design, POSIX shell compatibility, and minimal footprint (~2KB gzipped).
This repository contains the official Conventional Commits specification website, built with Hugo and a custom theme. It is a static documentation site with multi-language support (29 languages) across multiple specification versions (v1.0.0 and several beta releases). The site is deployed via Netlify with a Docker-based build pipeline. The codebase is primarily HTML/CSS/JS assets and Hugo layout templates, with no application logic, APIs, or data processing. The specification itself is the core content, presented as markdown files organized by version and language. While the theme demonstrates decent SCSS architecture and a language switcher, the overall codebase is simple and tightly coupled to the spec content, offering limited reusability beyond similar documentation sites.