clarifynl / sage-clarify-bs
WordPress starter theme with Laravel Blade components and templates, Bootstrap, and a modern development workflow
Installs: 13
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 0
Type:wordpress-theme
Requires
- php: ^8.0
Requires (Dev)
- squizlabs/php_codesniffer: 3.7.1
Suggests
- log1x/sage-directives: A collection of useful Blade directives for WordPress and Sage (^1.0).
- log1x/sage-svg: A useful SVG directive for inlining SVG's within Blade views (^1.0).
- dev-main
- v10.5.1
- v10.5.0
- v10.4.1
- v10.4.0
- v10.3.1
- v10.3.0
- v10.2.0
- v10.1.7
- v10.1.6
- v10.1.5
- v10.1.4
- v10.1.3
- v10.1.2
- v10.1.1
- v10.1.0
- v10.0.0
- 10.0.0-beta.3
- 10.0.0-beta.2
- 10.0.0-beta.1
- 9.0.10
- 9.0.9
- 9.0.8
- 9.0.7
- 9.0.6
- 9.0.5
- 9.0.4
- 9.0.3
- 9.0.2
- 9.0.1
- 9.0.0
- 9.0.0-beta.4
- 9.0.0-beta.3
- 9.0.0-beta.2
- 9.0.0-beta.1
- 9.0.0-alpha.4
- 9.0.0-alpha.3
- 9.0.0-alpha.2
- 9.0.0-alpha.1
- 8.6.0
- 8.5.4
- 8.5.3
- 8.5.2
- 8.5.1
- 8.5.0
- 8.4.2
- 8.4.1
- dev-dependabot/composer/guzzlehttp/psr7-2.5.0
This package is auto-updated.
Last update: 2024-04-19 23:07:19 UTC
README
WordPress starter theme with Laravel Blade components and templates, Tailwind CSS, and a modern development workflow
Website
Documentation
Releases
Support
Sponsors
Sage is an open source project and completely free to use.
However, the amount of effort needed to maintain and develop new features and products within the Roots ecosystem is not sustainable without proper financial backing. If you have the capability, please consider sponsoring Roots.
Features
- Harness the power of Laravel and its available packages thanks to Acorn.
- Clean, efficient theme templating utilizing Laravel Blade.
- Lightning fast frontend development workflow powered by Bud.
- Out of the box support for Tailwind CSS.
Requirements
Make sure all dependencies have been installed before moving on:
Theme installation
Install Sage using Composer from your WordPress themes directory (replace your-theme-name
below with the name of your theme):
# @ app/themes/ or wp-content/themes/
$ composer create-project clarifynl/sage-clarify-bs your-theme-name
To install the latest development version of Sage, add dev-main
to the end of the command:
$ composer create-project clarifynl/sage-clarify-bs your-theme-name dev-main
Make sure that you have Acorn installed. After activating your new sage based theme, setup Acorn's traditional structure and publish acorn vendor files:
# @ app/theme/your-theme or wp-content/themes/your-theme $ wp @development acorn acorn:init storage && wp @development acorn vendor:publish --tag=acorn
Theme structure
themes/your-theme-name/ # → Root of your Sage based theme ├── app/ # → Theme PHP │ ├── Providers/ # → Service providers │ ├── View/ # → View models │ ├── helpers.php # → Theme helper functions │ ├── Hooks.php # → Wordpress Hooks class │ └── setup.php # → Theme setup ├── composer.json # → Autoloading for `app/` files ├── public/ # → Built theme assets (never edit) ├── functions.php # → Theme bootloader ├── index.php # → Theme template wrapper ├── node_modules/ # → Node.js packages (never edit) ├── package.json # → Node.js dependencies and scripts ├── resources/ # → Theme assets and templates │ ├── fonts/ # → Theme fonts │ ├── images/ # → Theme images │ ├── scripts/ # → Theme javascript │ ├── styles/ # → Theme stylesheets │ └── views/ # → Theme templates │ ├── components/ # → Component templates │ ├── forms/ # → Form templates │ ├── layouts/ # → Base templates │ ├── partials/ # → Partial templates └── sections/ # → Section templates ├── screenshot.png # → Theme screenshot for WP admin ├── style.css # → Theme meta information ├── vendor/ # → Composer packages (never edit) └── bud.config.js # → Bud configuration
Theme setup
Edit app/setup.php
to enable or disable theme features, setup navigation menus, post thumbnail sizes, and sidebars.
Theme development
- Run
yarn
from the theme directory to install dependencies - Update
bud.config.js
with your local dev URL
Theme update
- Run
git fetch upstream
from the theme directory to update this start theme with it's upstream repository fromroots/sage
.
Build commands
yarn dev
— Compile assets when file changes are made, start Browsersync sessionyarn build
— Compile assets for production
Community
Keep track of development and community news.
- Join us on Discord by sponsoring us on GitHub
- Participate on the Roots Discourse
- Follow @rootswp on Twitter
- Read and subscribe to the Roots Blog
- Subscribe to the Roots Newsletter