=== Blockwist ===

Contributors: danbandi
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A flexible multipurpose block theme with native patterns, global styles, custom templates, and a child-theme-friendly foundation.

== Description ==

Blockwist is a modern multipurpose block theme. It provides a restrained
design system, broad template coverage, useful patterns, and small opt-in block
styles while staying close to WordPress core.

== Highlights ==

* Native full-site editing with no page-builder dependency.
* Fluid typography and spacing tokens.
* Blog, business, pricing, FAQ, testimonial, contact, and CTA patterns.
* Accessible focus states, reduced-motion handling, and responsive layouts.
* No JavaScript and no third-party font or asset requests.
* Parent CSS is loaded separately so child themes can safely build on it.
* Two native Header and two native Footer template parts, with light defaults.
* Default/Light, Dark, Midnight, Warm, and Minimal global styles.
* Full-width, no-title, Pattern Builder, Landing Page, and Blank custom templates.
* A native collection of 113 bundled SVG icons in the WordPress 7.1 Icon Library.
* Guarded compatibility for WordPress 6.6 through 7.0, where native icon registration is unavailable.
* One clear Blockwist category for reusable content patterns.

== Child themes ==

Create a child theme with this minimum style.css header:

/*
Theme Name: My Blockwist Child
Template: blockwist
Version: 1.0.0
*/

The parent loads assets/css/theme.css before the child style.css and avoids
registering the child stylesheet twice when the child has already enqueued it.
WordPress lets child themes override templates, template parts, patterns, and
theme.json settings through its supported child-theme resolution and merge behavior.
On WordPress 7.1 and later, native blockwist/* icon handles always resolve to the
canonical parent assets. Child themes that register native icons should use their
own collection slug. The separate four-icon compatibility helper uses child-aware
theme file resolution, so advanced child themes may replace one of its allowlisted
SVG files or define the guarded blockwist_get_icon() function before the parent loads.

Parent PHP callbacks are prefixed and guarded with function_exists(). Because a
child theme's functions.php loads first, advanced child themes can declare a
matching function before the parent loads. Prefer hooks and filters for ordinary
customization.

Available hooks:

* after_setup_theme: remove or add theme supports after the parent callback.
* wp_enqueue_scripts: dequeue blockwist-theme or add another stylesheet.
* init: unregister or replace Blockwist block styles and pattern categories.
* blockwist_features_enabled: reserved feature gate for child theme extensions.

== Pattern notes ==

Reusable patterns are grouped under the Blockwist category. Headers and footers
are editable template parts and do not appear as duplicate ordinary patterns.
Patterns contain intentionally generic starter copy and contact details. Replace
example contact information and starter calls to action before launch. Headers and
footers use native WordPress Navigation blocks with Page List fallbacks.

== Changelog ==

= 1.0.3 =
* Added the native Blockwist icon collection for WordPress 7.1, registering all 113 bundled SVG icons in the editor Icon Library.
* Standardized the 113 SVG assets as simple fill-based currentColor icons compatible with the WordPress 7.1 icon allowlist.
* Preserved WordPress 6.6-7.0 compatibility by making native icon registration a guarded no-op when the API is unavailable.
* Kept native blockwist icon paths parent-owned while retaining the existing child-aware four-icon helper for legacy patterns and older WordPress versions.
* Corrected Search to preserve the native WordPress query context for Pages and other searchable content.
* Updated documentation for the icon system, child-theme boundaries, and current WordPress.org release status.

= 1.0.2 =
* Updated the theme screenshot with neutral demo content for WordPress.org compliance.
* Updated corresponding pattern copy for consistency with the revised screenshot.

= 1.0.1 =
* Improved the default posts index and Site Editor template experience.
* Simplified the template hierarchy by allowing the Index template to provide the default posts index layout.
* Fixed post Query patterns so they do not inherit the current Page query.

= 1.0.0 =
* Rebuilt as a modern multipurpose block theme starter.
* Added complete site templates and custom page templates.
* Added section patterns and reusable block styles.
* Added child-theme-safe style loading and guarded setup functions.

== Resources ==

Blockwist WordPress Theme, Copyright 2026 Daniel Bandi.
Blockwist is distributed under the terms of the GNU GPL.

assets/images/hero-dark.webp
Original artwork by Daniel Bandi.
Copyright 2026 Daniel Bandi.
License: GPLv2 or later.

assets/images/hero-light.webp
Original artwork by Daniel Bandi.
Copyright 2026 Daniel Bandi.
License: GPLv2 or later.

assets/icons/*.svg
Original Blockwist icon artwork by Daniel Bandi.
Copyright 2026 Daniel Bandi.
License: GPLv2 or later.
