shear is a node CLI tool that helps you find usage of twig templates.
npm install -g shear
shear prune helps you find potentially unused templates.
Simply running shear prune without any arguments will report any twig files not found to be used in any other twig files in the project.
shear prune
A report typically looks like this:
Found 2 potentially unused templates:
- button-purchase.twig
- hero-banner.twig
Note that it reports potentially unused templates. shear can't recognize any dynamic template inclusion, extension or embedding (using string concatenation, for instance), so you need to double check the reported results to be certain it's never used.
The optional -t or --templates flag takes a list of filepatterns to find the usage of. The optional -s or --source flag takes a list of filepatterns to search in for usage:
shear prune --templates components/**/*.twig --source pages/**/*.twig
shear inspect reports a list of templates that are probably using it.
shear inspect components/button.twig
The optional -s or --source flag takes a list of filepatterns to search in for usage:
shear inspect components/button.twig -s pages/**/*.twig
shear dynamic reports a list of all templates in a project that contain concatenated or variable include, embed or extends.
shear dynamic
The optional -s or --source flag takes a list of filepatterns to search in for dynamic inclusion:
shear dynamic -s pages/**/*.twig