Updating Chisel
Chisel uses a two-tier architecture where core/ files can be updated independently from your project code.
Updating process
Run all commands inside your theme folder
Check for updates
npm run check-updateUpdate core files
npm run update-chiselOr run both at once:
npm run updateWarning: The update command will overwrite all files in the core/ folder. Your custom code in custom/ is never affected.
Core Folder Protection
The core/ folder contains base Chisel files that are updated automatically. A pre-commit hook will warn you if you try to commit modifications to these files.
Recommended approach
Instead of modifying core files directly, create corresponding files in the custom/ folder:
| Instead of modifying… | Create/modify… |
|---|---|
core/WP/Site.php | custom/app/WP/Site.php |
core/Helpers/ImageHelpers.php | custom/app/Helpers/ImageHelpers.php |
core/Timber/ChiselPost.php | custom/app/Timber/ChiselPost.php |
Bypassing the hook
If you understand the implications and need to commit core changes anyway:
# Option 1: Skip verification
git commit --no-verify
# Option 2: Use environment variable
CHISEL_SKIP_CORE_CHECK=1 git commit