themes-wordpress/seedlet
Ben Dwyer 839d682f5d
Merge pull request #3309 from Automattic/add/seedlet/extensibility-3134
Add filter to change bundled google fonts in assorted themes.
2021-05-05 18:58:34 +01:00
..
assets Seedlet: Add alignment support to the separator block 2021-04-20 09:18:24 -04:00
classes Fix wp_localize_script argument. 2021-02-25 10:53:10 -05:00
inc Seedlet: Update require paths (#3671) 2021-04-19 12:37:46 -07:00
languages update pot files from wpcom 2021-02-08 10:35:41 +00:00
template-parts Only hide site header/footer if the homepage is set to a static page. 2021-01-12 09:12:35 -05:00
404.php Seedlet: fix landmark roles (#2395) 2020-08-27 10:45:39 -04:00
archive.php Add description to category pages with styling 2021-01-04 00:23:41 +01:00
comments.php Replace with esc translation. (#2430) 2020-09-03 10:13:02 -04:00
footer.php dry blank canvas and seedlet 2021-01-08 16:42:41 +00:00
functions.php Add filter to change bundled google fonts. 2021-02-18 10:20:38 -05:00
header.php refactor seedlet and blank canvas so they share more code 2021-01-11 12:32:15 +00:00
image.php Change namespace. 2021-01-22 10:56:25 -05:00
index.php Refactor customizer class and add ability to toggle excerpts. 2020-10-22 14:22:30 -04:00
LICENSE Adding 1.0 seedlet theme. 2020-06-10 12:58:55 -04:00
package-lock.json rebuild and update version numbers 2021-03-08 10:48:58 +00:00
package.json Fix chroma comparison. 2021-03-16 10:51:33 -04:00
page.php Seedlet: fix landmark roles (#2395) 2020-08-27 10:45:39 -04:00
postcss.config.js Seedlet: Fix layout grid margins (#2219) 2020-07-07 12:04:08 -04:00
README.md Add an acknowledgement for the CSS Vars ponyfill 2020-10-05 11:23:59 +01:00
readme.txt Bump minor version. 2021-02-25 12:25:58 -05:00
screenshot.png Seedlet: Optimize the screenshot 2020-07-24 02:11:15 +02:00
search.php Use correct template tags for navigation + pagination. 2020-10-14 10:23:00 -04:00
single.php Use correct template tags for navigation + pagination. 2020-10-14 10:23:00 -04:00
style-rtl.css Seedlet: Add alignment support to the separator block 2021-04-20 09:18:24 -04:00
style.css Seedlet: Add alignment support to the separator block 2021-04-20 09:18:24 -04:00

Seedlet

Seedlet is simple, text-driven WordPress theme.

Along with being an excellent standalone theme, Seedlet is designed to be a parent-theme that allows folks to quickly create Gutenberg-ready child-themes for WordPress. [Instructions for how to make child themes are coming soon]

Development

To make changes to the styles, node.js is recommended:

  1. npm i to install the required development dependencies
  2. npm start to start the development server
  3. Make changes in assets/sass

Technical Overview

Principles

When you reduce a theme design down to a set of systematic design decisions, you end up with something called a Style Guide. The Seedlet system works by taking the rules of a Style Guide and expressing them through carefully placed variables or design tokens that influence the appearance of a WordPress site.

This unifies the design decisions needed to style the aesthetic appearance of Gutenberg Blocks, the theme Header + Footer areas, WooCommerce, Jetpack and more. It also syncs styles between the editor and the frontend so that you dont need to hand-write CSS for both. This greatly speeds up the Gutenberg theme development process and reduces the amount of manual styling that typically goes into developing a theme.

Controls

The theme is built to offer the following controls:

  • Fonts - Font-family, size, weight, and line-height rules.
  • Colors - Primary, secondary, background, foreground and border colors.
  • Spacing - A default 8px vertical rhythm between all blocks and major components. It also includes utility spacing classes for negative margins.
  • Responsive Logic - Built-in responsive behavior across Blocks and Components.

Structure

The system itself lives in the /assets/sass directory as a collection of Sass partials broken up by scope and hierarchy. The partials get compiled down to singular CSS files that live in the main Seedlet directory and cascade downward like so:

Frontend

  • /assets/css/variables.css
  • /style.css

Editor

  • /assets/css/variables-editor.css
  • /style-editor.css

In each view, the variables are loaded first and then the stylesheet is loaded which applies the variables.

License

GNU General Public License v2 or later.

URI: LICENSE

Acknowledgments

CSS vars ponyfill: https://github.com/jhildenbiddle/css-vars-ponyfill