Trellis Tools

A collection of tools to enhance your Roots Trellis workflow and configuration.

Tools Overview

1. Trellis Updater

A Bash script to safely update your Trellis installation while preserving your custom configurations.

Features

• Creates a backup of your current Trellis directory
• Downloads the latest version of Trellis
• Updates your Trellis files while preserving important configurations
• Commits changes to your Git repository

For detailed usage instructions and information, please refer to the Trellis Updater documentation.

Note: If you prefer not to use the automated shell script, we also provide a manual update guide with step-by-step instructions.

2. Nginx Image Configuration

Tools to configure Nginx for optimized image serving, supporting WebP and AVIF formats.

Features

• Automatically serves WebP or AVIF images when browsers support them
• Falls back to traditional formats for older browsers
• Improves page load times and performance scores

Usage

The configuration is located in the image-optimization/nginx-includes/webp-avf.conf.j2 file.

For detailed instructions on implementing this in your Trellis project and converting your images to WebP/AVIF formats, please refer to our Image Optimization Guide.

To implement this in your Trellis project:

1. Copy the image-optimization/nginx-includes directory to your Trellis project
2. Update your Trellis configuration to include this Nginx configuration
3. Run the appropriate provisioning command to apply the changes:

   # For production environment
   trellis provision production
   
   # For staging environment
   trellis provision staging
   
   # For development environment
   trellis provision development

Requirements

• Git
• Bash
• rsync

License

MIT License. See LICENSE.md for details.

Author

Copyright © Imagewize