=== Blockwist ===

Contributors: danbandi
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
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.
* Categorized, theme-owned SVG icon assets for reusable pattern treatments.
* 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.
The provided icon helper uses child-aware theme file resolution for its allowlisted
SVG files. Advanced child themes may replace an allowlisted icon at the same path
or replace 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.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.
