In Depth
Keeping your theme up-to-date (or not)
How to update, and whether or not you should
_tw does not have versions, and there is no expectation of backwards compatibility between the most recent version and ones from the past. This philosophy matches that of _s, as outlined in the post, Don’t Update Your Theme (From _s).
In summary, once you generate your theme, you shouldn’t worry about keeping it in sync with every change from _tw.
Nonetheless, you may want to update to the latest version of Tailwind within your previously generated theme. It’s generally safe to use npm update
, though you’ll always want to make sure you have a past commit you can go back to in case things go wrong. Alternatively, you could copy the most recent devDependencies
from package.json
and the most recent package-lock.json
and then run npm install
.
But you may not find even updates of this sort to be necessary unless you specifically need a new Tailwind feature.
If there are bugs in _tw, or if _tw’s integration with WordPress or another dependency breaks for any reason, you will find commits specific to fixing those bugs on GitHub alongside a list of steps to fix the bug in an existing theme, usually within the corresponding issue for that bug.
All Documentation
- Quickstart
Get started quickly, and deploy to production sooner than you expect
Fundamentals
- Installation
Generate your custom theme, install it in WordPress and run your first Tailwind builds - Development
Watch for changes, build for production and learn more about how _tw, WordPress and Tailwind work together - Deployment
Share your new WordPress theme with the world - Troubleshooting
Find solutions to potential issues and answers to frequently asked questions
In Depth
- Using Tailwind Typography
Customize front-end and back-end typographic styles - JavaScript Bundling with esbuild
Install and bundle JavaScript libraries (very quickly) - Linting and Code Formatting
Catch bugs and stop thinking about formatting - Keeping your theme up-to-date (or not)
How to update, and whether or not you should
Extras
- On Tailwind and WordPress
Understand how WordPress and Tailwind work together - Styling HTML from outside the theme
Work with WordPress core, plugins and JavaScript libraries - Managing Styles for Custom Blocks
Learn strategies for using Tailwind in theme-specific custom blocks - Setting Up Browsersync
Add live reloads and synchronized cross-device testing to your workflow