craft-twig-guidelines

What problem does it solve?

Twig coding standards and conventions to ensure consistent, maintainable Craft CMS 5 templates across teams and projects.

Core Features & Use Cases

• Enforces consistent variable naming (camelCase, no abbreviations) and robust null handling with ?? (and the optional ??? plugin if present).
• Guidelines for whitespace control, include isolation (always use 'only'), and usage of Craft Twig helpers (tag, attr, |attr, |parseAttr, |append, svg()).
• Promotes collect() usage for props and class collections, and requires comment headers in components for clarity and maintainability.
• Helps avoid common pitfalls like snake_case, macros for components, and hardcoded colors, enabling scalable template development.

Quick Start

Start applying these Twig conventions whenever creating, editing, or reviewing any .twig file in a Craft CMS 5 project to ensure consistent templates.