=== Wuppi ===
Contributors: ambronet
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.4.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: blog, e-commerce, one-column, two-columns, grid-layout, right-sidebar, full-width-template, full-site-editing, block-patterns, block-styles, style-variations, wide-blocks, custom-colors, custom-logo, custom-menu, editor-style, featured-images, theme-options, translation-ready

A calm, white-label block theme for service businesses, consultants, practitioners, and creatives, with editable templates, built-in responsive visibility controls, self-hosted assets, and a translation-ready foundation.

== Description ==

Wuppi is a calm, white-label block theme built for service businesses, consultants, practitioners, and creatives. It is designed for projects that need a polished starting point, flexible branding, and a layout system that can be adapted quickly for different clients and use cases.

For additional custom blocks and service-focused patterns — including icons, testimonials, accordions, pricing tables, team members, and more — install the free [Wuppi Blocks](https://wordpress.org/plugins/wuppi-blocks/) companion plugin.

The theme is built around the WordPress block editor (Gutenberg) and Site Editor, so templates, template parts, patterns, and global styles can be adjusted without leaving the editing workflow. Wuppi includes editable header and footer template parts, custom templates such as Blank Canvas, Home Hero Flex, Calm Hero Page, and Post With Sidebar, plus bundled starter layouts for home, about, and contact pages.

Wuppi ships with self-hosted font families, curated color and spacing presets, appearance tools, responsive embeds, featured image support, and multiple style variations to help you move from a soft, minimal look to a more structured professional presentation. Bundled section patterns cover key marketing pages with ready-made areas for services, testimonials, FAQs, pricing, latest posts, and contact details.

Wuppi includes built-in responsive visibility controls: add a simple class to any block to show or hide it on mobile, tablet, or desktop — no coding required. It works with any block in the editor, including core blocks and third-party blocks.

For practical setup, Wuppi includes a dedicated settings screen for header height, navigation spacing, and desktop or mobile header behavior, along with a built-in help page under Appearance. WooCommerce archive and single-product templates are included for shops and service add-ons, and the theme is translation-ready with the `wuppi` text domain. Learn more at https://www.ambronet.dk/wuppi and about the developer at https://www.ambronet.dk.

== Features ==

* Block theme — edit templates, header, footer, and global styles in the Site Editor
* Built-in responsive visibility — show or hide any block on mobile, tablet, or desktop without writing code
* Header and footer template parts editable in Site Editor
* Local self-hosted fonts (no remote font requests)
* Translation-ready (`wuppi` text domain)
* WooCommerce-compatible archive and single product templates
* Starter patterns and style variations
* Optional back to top button, configurable in Wuppi Settings

== Installation ==

1. Upload the theme folder to `/wp-content/themes/` or install the ZIP package.
2. Activate **Wuppi** in **Appearance > Themes**.
3. Customize templates, patterns, and styles in **Appearance > Editor**.

== Screenshots ==

1. Wuppi front page using the Shoji Warm style variation, showing the hero, services grid, and testimonials section.

== Credits ==

= Fonts =

Source Sans 3
Copyright: Source Sans 3 Project Authors
License: SIL Open Font License 1.1 - https://scripts.sil.org/OFL
Source: https://fonts.google.com/specimen/Source+Sans+3

Cormorant Garamond
Copyright: Christian Thalmann
License: SIL Open Font License 1.1 - https://scripts.sil.org/OFL
Source: https://fonts.google.com/specimen/Cormorant+Garamond

Playfair Display
Copyright: Playfair Display Project Authors
License: SIL Open Font License 1.1 - https://scripts.sil.org/OFL
Source: https://fonts.google.com/specimen/Playfair+Display

Montserrat
Copyright: Julieta Ulanovsky, Sol Matas, Juan Pablo del Peral, Jacques Le Bailly
License: SIL Open Font License 1.1 - https://scripts.sil.org/OFL
Source: https://fonts.google.com/specimen/Montserrat

Lora
Copyright: Cyreal
License: SIL Open Font License 1.1 - https://scripts.sil.org/OFL
Source: https://fonts.google.com/specimen/Lora

Nunito Sans
Copyright: Vernon Adams, Jacques Le Bailly, Manvel Shmavonyan
License: SIL Open Font License 1.1 - https://scripts.sil.org/OFL
Source: https://fonts.google.com/specimen/Nunito+Sans

Raleway
Copyright: Raleway Project Authors
License: SIL Open Font License 1.1 - https://scripts.sil.org/OFL
Source: https://fonts.google.com/specimen/Raleway

Roboto
Copyright: Christian Robertson
License: Apache License 2.0 - https://www.apache.org/licenses/LICENSE-2.0
Source: https://fonts.google.com/specimen/Roboto

= Icons =

Lucide SVG icons
Copyright: Lucide Contributors
License: ISC - https://lucide.dev/license
Source: https://lucide.dev

= Images =

assets/images/ref-room.webp
Copyright: ambronet, 2026
License: GPL-2.0-or-later - https://www.gnu.org/licenses/gpl-2.0.html

assets/images/ref-portrait.webp
Copyright: ambronet, 2026
License: GPL-2.0-or-later - https://www.gnu.org/licenses/gpl-2.0.html

assets/images/default-logo.png
Copyright: ambronet, 2026
License: GPL-2.0-or-later - https://www.gnu.org/licenses/gpl-2.0.html

== Frequently Asked Questions ==

= Is there a companion blocks plugin? =
Yes. [Wuppi Blocks](https://wordpress.org/plugins/wuppi-blocks/) is a free companion plugin that adds custom blocks and ready-made section patterns optimised for use with this theme.

= Does Wuppi require a page builder or plugin? =
No. Wuppi is a native WordPress Full Site Editing block theme. Everything is handled through the built-in Site Editor — no page builder or third-party plugin is required.

= Which WordPress version is required? =
WordPress 6.5 or later is required. PHP 8.0 or later is recommended.

= Is WooCommerce supported? =
Yes. Wuppi includes WooCommerce archive and single-product templates so your shop pages are styled consistently with the rest of the site.

= Can I use Wuppi for client projects? =
Yes. Wuppi is released under the GPLv2 or later license, so you are free to use and adapt it for client work.

= Where can I find documentation and support? =
Documentation and support are available at https://www.ambronet.dk/wuppi.

== Changelog ==

= 1.4.1 =
* Mobile menu: slide-down overlay with improved animation and tap handling
* Fix mobile image display issues
* Center-align text blocks on mobile across templates

= 1.4.0 =
* Add Copenhagen style variation with self-contained color palette and matching Copenhagen Harbor color set
* Add Media Cards pattern: three image-led cards using the Wuppi Media Card group style
* Declare compatibility with WordPress 7.0

= 1.3.2 =
* Fix automated theme check: replace remove_action on core wp_head hook with a CSS override; add explicit copyright comment to style.css

= 1.3.1 =
* Remove build tooling files (package.json, package-lock.json, webpack.config.js) from distribution package

= 1.3.0 =
* Rewrite the Settings admin page as a React app with live iFrame preview, tabbed navigation (General, Header, Design, Buttons, Advanced), color/radius/padding preset pickers, and a REST-backed save flow

= 1.2.0 =
* Add default blog page with sidebar, refine blog listing styles (thumbnails, meta, excerpt CTA, pagination), add calendar date icon, editorial hero styling for blog, optional author meta, and editable blog hero gradient

= 1.1.0 =
* Add responsive visibility utility classes: `wuppi-hide-mobile`, `wuppi-hide-tablet`, `wuppi-hide-desktop`, `wuppi-show-mobile`, `wuppi-show-tablet`, `wuppi-show-desktop`

= 1.0.9 =
* Add dismissible admin notice suggesting the Wuppi Blocks companion plugin when it is not active
* Add companion plugin cross-link to readme description and FAQ

= 1.0.8 =
* Reappear header on mouse move when auto-hide is active; keep header visible while pointer is over it

= 1.0.7 =
* Fix card alignment and remove hard-coded font weights

= 1.0.6 =
* Normalize Ambronet heading weights to Montserrat 500 for more consistent typography
* Keep service cards aligned to equal heights in the services grid

= 1.0.5 =
* Add additional theme tags for WordPress.org metadata and declare explicit custom logo support

= 1.0.4 =
* Move the WordPress.org preview blueprint into assets/blueprints for the packaged theme and release staging
* Revert the theme license header to GPL-2.0-or-later to match the original submission format

= 0.1.3 =
* Add optional back to top button with smooth scroll, configurable in Wuppi Settings

= 0.1.2 =
* Refine Ambronet typography weights and normalize services overview card headings

= 0.1.1 =
* Remove block-theme from style.css tags (auto-assigned by WordPress.org)

= 0.1.0 =
* Initial public release
