=== Kairo ===
Contributors: shameemreza
Requires at least: 6.4
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.6
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A minimal, lightning-fast WordPress block theme designed for personal brand websites and blogs.

== Description ==

Kairo is a minimal, lightning-fast WordPress block theme designed for personal brand websites and blogs. It prioritizes readability and performance while providing a beautiful, modern aesthetic that helps individuals establish their online presence without complexity.

Built with performance in mind, Kairo aims for a perfect 100/100 Lighthouse score by using local fonts, fluid typography, and minimal CSS.

= Features =

* **Full Site Editing:** 100% block-based with no PHP templates required.
* **Light & Dark Mode:** Built-in dark mode toggle block.
* **Performance First:** Local fonts, fluid spacing, and minimal CSS for optimal Core Web Vitals.
* **GDPR Compliant:** Self-hosted fonts with no external requests.
* **Accessibility Ready:** WCAG 2.1 AA compliant with proper focus states and semantic HTML.
* **Translation Ready:** Fully translatable with proper text domains.
* **Multiple Hero Layouts:** Five hero section patterns included.
* **Blog-Focused:** Designed specifically for personal blogs with excellent typography.
* **Responsive:** Mobile-first design with fluid typography and spacing.

= Block Patterns =

Kairo includes several block patterns to help you get started:

**Hero Sections:**
* Hero Photo: Left Split layout with photo on left.
* Hero Photo: Right Split layout with photo on right.
* Hero Photo: Centered Centered layout with photo above content.
* Hero Centered: Text-only centered hero.
* Hero With Newsletter: Hero with integrated newsletter signup.

**Posts:**
* Posts Grid: A grid layout for displaying blog posts.
* Posts List: Simple list layout for blog posts.
* Posts Cards: Card-style layout for blog posts.
* Posts Featured: Highlight a featured post.
* Blog Archive: Full archive page layout.

**Gallery & Video:**
* Gallery Grid: Photo gallery in grid layout.
* Gallery Mosaic: Photo gallery in mosaic layout.
* Video Featured: Featured video embed.
* Video Grid: Multiple video embeds in grid.

= Style Variations =

* Default (Light): Clean, minimal light theme.
* Dark: Easy-on-the-eyes dark mode.

== Installation ==

1. In your admin panel, go to Appearance > Themes and click the "Add New" button.
2. Click "Upload Theme" and choose the zip file you downloaded.
3. Click "Install Now" and then "Activate" to use Kairo.

== Frequently Asked Questions ==

= Does this theme support any plugins? =

Kairo works well with all major plugins. It's specifically designed to work seamlessly with the WordPress block editor and Full Site Editing.

= How do I customize the theme? =

Use the Site Editor (Appearance > Editor) to customize all aspects of the theme including colors, typography, header, footer, and page layouts.

= How do I add my profile photo? =

Edit the hero pattern in the Site Editor and replace the placeholder image with your own photo.

= How do I enable dark mode? =

Add the "Dark Mode Toggle" block to your header. Users can then switch between light and dark modes.

== Changelog ==

= 1.0.6 =
* Added Jetpack Subscriptions integration to newsletter block for WordPress.com compatibility.
* Fixed dark mode toggle CSP compatibility for managed hosting and WordPress.com.
* Fixed code block text visibility in dark mode for WordPress.com/Jetpack syntax highlighting.
* Improved posts grid pattern with smaller titles (1rem) for better balance.
* Increased excerpt word count from 12 to 25 words (~150 characters) for better SEO.
* Added newsletter block to single post template by default.
* Added accent border styling for newsletter on single posts for visual distinction.

= 1.0.5 =
* Replaced screenshot images with AI-generated GPL-compatible images.
* Updated image credits in readme.txt.

= 1.0.4 =
* Updated screenshot images to use GPL-compatible Unsplash photos.
* Updated image credits in readme.txt.

= 1.0.3 =
* Added Theme URI pointing to theme information page.
* Added screenshot image credits and license information.
* Improved blog/archive layout consistency.
* Added sticky post styling with "Featured" badge.
* Enhanced newsletter block dark mode visibility.
* Improved list item bullet styling.

= 1.0.0 =
* Initial release

== Resources ==

= Fonts =

Inter Variable Font
Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
License: SIL Open Font License, Version 1.1
License URL: https://openfontlicense.org
Source: https://rsms.me/inter/

= Images =

Placeholder avatar SVG is self-created and released under GPL.

Screenshot Images:
All images in the screenshot are AI-generated using ChatGPT (DALL-E) and released under GPL.

Author Avatar in Screenshot:
AI-generated image created using ChatGPT from author's own photo, released under GPL.

Article Thumbnail Images in Screenshot:
AI-generated images created using ChatGPT (DALL-E), released under GPL.

= Icons =

All icons are inline SVGs, self-created and released under GPL.

== Copyright ==

Kairo WordPress Theme, (C) 2025 Shameem Reza

Kairo is distributed under the terms of the GNU GPL

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
