Troubleshooting

Common issues and fast fixes when developing with Turbo.

Styles not updating

Run a fresh build

npm run build

Install the theme

wp-content/themes/bbi-turbo

If you edited block styles

npm run build:blocks-css

Clear any cache plugins or server cache.

Editor styles look different from frontend

• Make sure npm run build has been run.
• Confirm public/build/ exists and contains compiled assets.
• Clear cache and reload.

Blocks missing or not showing

• Confirm the Turbo Blocks plugin is active.
• Check for PHP errors in wp-content/debug.log.
• Rebuild block styles with npm run build:blocks-css.

Video banner not loading

• On mobile, only the poster shows by design.
• On desktop, the iframe loads only when the banner is in view.
• If you changed video logic, clear cache and re‑test.

Permalinks / routing issues

Go to Settings → Permalinks and click Save.

This refreshes rewrite rules.

General reset

If things still feel broken:

• Clear cache plugins.
• Rebuild assets (npm run build).
• Refresh permalinks.
• Hard‑refresh the browser