Quality over Quantity (QoQ)

A streamlined suite of tools to format, lint, and analyze any JavaScript/TypeScript project with minimal setup.

🚀 Why QoQ?

• 🛠 Zero-hassle Configuration – Set up once and focus on coding.
• ⚡ Optimized Performance – Run tools efficiently without redundant overhead.
• 🔬 Precision over Bulk – Enforce best practices with well-curated presets.

📦 What's Included?

QoQ provides essential tooling to ensure code quality across all your projects:

• ESLint v9 – Enforce best practices with extendable, opinionated presets.
• Prettier – Automatically format code for consistency.
• Knip – Detect and remove unused code effortlessly.
• JSCPD – Identify and eliminate duplicate code.
• Stylelint – Lint CSS/SCSS with opinionated presets.
• Structurelint – Validate project file/folder structure (via @ladamczyk/structurelint).
• Skillslint – Lint Claude Code skill documentation (via @ladamczyk/skillslint).
• npm outdated checks – Flag stale dependencies on a configurable cadence.

Most tools are available as an independent package under the @ladamczyk/qoq-* namespace, making it easy to integrate and customize. Structurelint and Skillslint are optional integrations backed by separate @ladamczyk/structurelint and @ladamczyk/skillslint packages.

🚀 Getting Started

1️⃣ Install QoQ

npm install @ladamczyk/qoq-cli

2️⃣ Set Up Configuration

QoQ uses an intuitive Config Wizard to guide you through setup. Run:

npx -y @ladamczyk/qoq-cli --init

This will generate a qoq.config.js file with all necessary configurations.

3️⃣ Run Quality Checks

• qoq --check – Runs a full code check, typically used in the CI lint step or pre-push hook.
• qoq staged – Checks only staged changes, typically used in the pre-commit hook.
• qoq --fix – Fixes issues where possible, typically triggered manually after hooks or a CI failure to quickly correct problems.

🏗 Project Structure

QoQ is designed for flexibility and ease of use. Its core components include:

📂 Config Wizard – Guides setup and generates a config file. 📂 Config Handlers – Manages default and user-defined settings. 📂 Executors – Executes commands efficiently, handling errors and performance optimizations.

For more details, check out our technical documentation.

🌍 Contributing

Join us in making QoQ even better! Read our Contributing Guidelines before submitting changes.

---

💡 QoQ: Focus on writing great code, we handle the rest.

Feel free to join us, please read Contributing Guidelines