Sage Versions Save

📣 Read our announcement on the Roots blog

🌱 Join us on Roots Discourse to discuss the Sage 10 release

Highlights

• Sage 10 requires Acorn — it allows us to use Laravel Blade templates along with Laravel Components, Composers, and more
• Tailwind CSS is included and we've left you with a clean slate to start styling your site
• Bud is our new build tool and responsible for building assets in Sage 10

Additional changes

• theme.json is used for global editor settings
• jQuery has been removed
• All base styles have been removed
• Customizer starter has been removed
• Core theme files are back in the theme root (index.php, functions.php) for better plugin & child theme compatibility

Thank you

Thank you to everyone who contributed code and docs towards Sage 10, Acorn, and Bud:

@Akiletour, @alwaysblank, @aplr, @austinpray, @clayrisser, @dsturm, @gandalfar, @greghunt, @huubl, @joshuafredrickson, @kellymears, @kingkero, @knowler, @LeoColomb, @mallardduck, @MWDelaney, @ouun, @oxyc, @plumthedev, @pxlrbt, @SergiArias, @simonhammes, @stefanfisk, @strarsis, @TangRufus, @tdinia, @theMosaad, @tylerwiegand, @valeravilks, @wolfgangschaefer

---

Changelogs:

• https://github.com/roots/sage/compare/10.0.0-beta.3...v10.0.0
• https://github.com/roots/sage/compare/10.0.0-beta.2...10.0.0-beta.3
• https://github.com/roots/sage/compare/10.0.0-beta.1...10.0.0-beta.2
• https://github.com/roots/sage/compare/9.0.9...10.0.0-beta.1

🌱 Join us on Roots Discourse to discuss the Sage 10.0.0-beta.3 release

What's new

Acorn has been removed as a dependency in Sage's composer.json. We recommend installing Acorn from Bedrock's composer.json, or as a mu-plugin in non-Bedrock environments. Acorn is still required in order to use Sage, and Sage will exit immediately with an error if Acorn isn't available. We've also removed the config and bootstrap directories from Sage, and default to a zero-config setup.

See the Acorn installation and zero-config docs for more details.

Bud has shipped several releases since being included in beta 2, in which many bug fixes, performance improvements, and developer experience improvements have landed.

https://user-images.githubusercontent.com/115911/153884517-4dbab731-3122-4be9-aed5-b8cbd514cebd.mp4

Sage has moved the global editor settings from setup.php into theme.json and now requires WordPress 5.9+.

Changes

• migrate global settings to theme.json (#2964) @retlehs
• Re-add i18n related scripts/tasks (#2958) @strarsis
• chore(header): allow unescaped siteName data (#2967) @Akiletour
• Switch to zero-config setup, remove config and bootstrap directories (#2839) @retlehs @QWp6t
• chore: remove helpers.php (#2917) @Log1x
• refactor: remove JavaScript detection (#2916) @knowler
• chore(php): bump minimum PHP version to 7.4 (#2925) @knowler
• enhance(views): Move page section views to a sections directory (#2936) @retlehs @Log1x
• feat(search): use a button element (#2943) @knowler

Fixes

• fix(views): Use dot notation on entry-meta view includes (#2941) @Log1x
• fix: app/setup.php doesn’t need to be executable (#2933) @knowler
• fix(bundle-editor): remove @wordpress/edit-post (#2932) @retlehs

Full Changelog: https://github.com/roots/sage/compare/10.0.0-beta.2...10.0.0-beta.3

Sage 10.0.0-beta.3 contributors: @retlehs @QWp6t @Log1x @knowler @simonhammes @kellymears @Akiletour @strarsis @alwaysblank

🌱 Join us on Roots Discourse to discuss the Sage 10.0.0-beta.2 release

What's changed

Major changes

• Tailwind CSS v3.0 (#2882)
• Replace Laravel Mix with Bud ⚡ (#2643)

Additional changes

• Remove customizer starter (#2904)
• Move compiled views back to cache dir by default (#2837)
• chore(theme): misc cleanup (#2862)
• Remove all base styles (#2889)
• Remove all base styles followup (#2900)
• feat(theme-wrapper): remove shrink-to-fit=no (#2870)
• fix(lint): Add additional known at-rules (#2811)
• chore(deps): Bump roots/acorn to v2.0.0-beta.6 (#2911)

Sage 10.0.0-beta.2 contributors: @retlehs @kellymears @QWp6t @knowler @joshuafredrickson

Full Changelog: https://github.com/roots/sage/compare/10.0.0-beta.1...10.0.0-beta.2

What's changed

Major changes

• feat(assets): Change default CSS framework to Tailwind
• feat(deps): Sunset sage-lib and transition over to Acorn. (#2122)
• feat(view): Implement Blade Composers – a native, robust, more powerful solution to "Controllers" used in Sage 9.
• feat(assets): Change asset build system to Laravel Mix. (#2172)

Additional changes

• enhance(assets): Refactor and simplify the stylesheet and script stubs.
• enhance(assets): Shorter pattern for purge files (#2722)
• enhance(blocks): Implement block editor support.
• enhance(ci): Change from CircleCI to GitHub actions
• enhance(filters): Remove required template filters from the theme as they are now handled automatically by Acorn.
• enhance(functions): Improve the functions.php autoloader implementation.
• enhance(handler): Implement Whoops support for better error handling during development.
• enhance(theme): Add theme support for custom-line-height
• enhance(theme): Add theme support for custom-units
• enhance(theme): Add theme support for editor-gradient-presets, editor-font-sizes, disable-custom-colors, disable-custom-gradients, disable-custom-font-sizes, custom-spacing
• enhance(theme): Disable full-site editing support (#2692)
• enhance(theme): Implement necessary starter project boilerplate for Acorn.
• enhance(theme): Move core theme files back to the theme root (index.php, functions.php, etc.) for better plugin & child theme compatibility.
• enhance(theme): Remove theme support for default block patterns
• enhance(theme): Restructure project directories to mirror Laravel for use with Acorn.
• enhance(view): Add "skip to content" link (#2622)
• enhance(view): Improve the readability and syntax of the default Blade views.
• chore(config-log): use generic application.log
• chore(deps): Bump dependencies including Bootstrap, jQuery, etc.
• chore(deps): Bump PHP requirement to 7.2.5.
• chore(deps): Bump WordPress requirement to 5.2.
• chore(deps): optimize tailwind's purgecss dirs
• chore(deps): Update config files to reflect Acorn.
• chore(theme): Fix docblock link
• chore(theme): Move custom-spacing up for visibility
• chore(theme): Remove specificity from custom-units theme support
• chore(theme): Remove various configuration files that are no longer in use.
• chore(theme): Reorder actions inside of the after_setup_theme hook by usefulness
• fix(assets): use PhpAsset::load()
• fix(bootstrap): use static bootloader to prevent rebooting
• fix(composer): use proper wp cli command name (#2636)
• fix(config-view): use acorn helper functions
• fix(deps): Remove wildcards from .copyDirectory() in webpack.mix.js
• Fix/add translators comment (#2716)
• Make jQuery 3.5.1 a peer dependency (#2721)
• Remove deprecated jQuery .ready() syntax (#2738)
• Remove redundant x-ua-compatible meta tag (#2742)
• Use menu name as accessible name of <nav> (#2814)
• Enable Webpack 5's automatic unique naming (#2745)

Sage 10.0.0-beta.1 contributors: @Log1x @retlehs @QWp6t @TangRufus @knowler @dsturm @huubl @joshuafredrickson @strarsis @greghunt

• Update Node dependencies (#2572)
• Composer 2 compatibility (#2569)

• Update to Bootstrap 4.3.1 (#2153)

• Update to Bootstrap 4.3.0 (#2152)
• Filter template hierarchy for embed templates (#2145)
• Decrease optipng level (#2143)
• Unescape post titles (#2141)

Updates dependencies and build process. Most notably, uses Gulp 4.

• Update sage-installer which now allows to opt-in for sending framework selection data (#2137)

• Update to Bootstrap 4.2.1 (#2136)
• Do not ignore vendors for plugins (#2132)
• Fix stylelint and eslint validation errors (#2131)
• Hook run sequence fix (#2123)
• Dispatch event when firing routes (#2080)
• Normalize and enforce single quotes (#2076)