=== BBH Lite ===
Contributors: bbhteam
Tags: blog, custom-logo, custom-menu, editor-style, featured-images, footer-widgets, full-width-template, right-sidebar, sticky-post, threaded-comments, translation-ready, block-patterns, block-styles, wide-blocks, rtl-language-support
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

BBH Lite is a lightweight, responsive WordPress theme built for performance, accessibility, and modern editing workflows. It supports the block editor with wide and full alignment, is compatible with Elementor and WooCommerce, and includes a multi-level navigation system, widgetized footer, and featured-image-based layouts for posts and pages.

== Description ==

BBH Lite is a lightweight, responsive WordPress theme designed for performance, accessibility, and compatibility with modern WordPress editing features.

**Key Features:**

* **Navigation:** Multi-level dropdown menus with CSS + vanilla JavaScript, full keyboard navigation (Arrow keys, Escape, Tab), touch support, and mobile full-screen overlay with smooth slide-in animation
* **Widget Areas:** Main sidebar and four footer widget columns. Manage via Appearance > Widgets.
* **Customizer:** Editable copyright text with dynamic year and site name placeholders, footer widget toggle, and five social media link controls (Facebook, Twitter/X, Instagram, LinkedIn, YouTube)
* **Post & Page Hero:** Featured image displays as a full-width hero with title and meta data overlaid on a dark gradient. Falls back to a clean title bar when no image is set.
* **Page Templates:** Full Width template with no sidebar and optional title hiding via post meta checkbox
* **Gutenberg:** Full block editor support with theme.json v2, wide and full alignment, block styles, block patterns, custom spacing, and custom units
* **Elementor:** Compatible with Elementor page builder.
* **WooCommerce:** Compatible with WooCommerce.
* **Accessibility:** Includes skip links, ARIA labels, keyboard navigation, focus management, and screen reader text to improve usability across different user needs.
* **Performance:** Zero jQuery dependency, optimized CSS and JavaScript with no external dependencies, print-optimized styles
* **Internationalization:** Full translation support with POT file included, RTL language stylesheet included

== Installation ==
1. In your WordPress admin, navigate to **Appearance > Themes**.
2. Click **Add New**, then **Upload Theme**.
3. Choose the `bbh-lite.zip` file and click **Install Now**.
4. Click **Activate** after installation completes.
5. Go to **Appearance > Customize** to configure the theme settings.

**Manual Installation:**

1. Download the theme and extract the `bbh-lite` folder.
2. Upload the folder to `/wp-content/themes/` via FTP or your hosting file manager.
3. Navigate to **Appearance > Themes** in WordPress admin and click **Activate** on BBH Lite.

**After Activation:**

1. Upload your logo via **Appearance > Customize > Site Identity**.
2. Set your site icon (favicon) in the same section.
3. Assign menus in **Appearance > Menus** for Primary and Footer locations.
4. Configure footer content and social links under **Appearance > Customize > Footer Builder**.
5. Add widgets to the sidebar and footer columns under **Appearance > Widgets**.

== Frequently Asked Questions ==

= Does this theme support Elementor? =
Yes. BBH Lite is compatible with the Elementor page builder. Theme locations for header, footer, single post, and archive are registered so you can build custom layouts with Elementor Theme Builder.

= Is it Gutenberg-ready? =
Yes. The theme supports block styles, theme.json v2, wide/full alignment, block patterns, custom spacing units (px, em, rem, %, vh, vw), and appearance tools. The block editor styles match the front-end design.

= Is jQuery required? =
No. All front-end JavaScript is written in vanilla JavaScript with no jQuery dependency. jQuery is only loaded within the Customizer preview for live-preview updates (admin-only, does not affect front-end performance).

= How do I add social media links? =
Navigate to **Appearance > Customize > Footer Builder** and enter the full URL for each social platform you want to display: Facebook, Twitter/X, Instagram, LinkedIn, and YouTube. Icons appear automatically.

= How do I customize the footer copyright text? =
Go to **Appearance > Customize > Footer Builder** and enter your custom text in the Copyright Text field. Use `{{year}}` for the current year and `{{site}}` for your site name. Leave it empty to use the default format.

= Does the theme support widgets? =
Yes. BBH Lite registers five widget areas: one main sidebar and four footer columns. Manage them via **Appearance > Widgets**.

= How do I create a full-width page without a sidebar? =
When editing a page, look for **Page Attributes** in the right sidebar. Under **Template**, select **Full Width**. This removes the sidebar and gives you a full-width canvas for the block editor. You can also check the **Hide page title** checkbox to hide the page title on the front end.

= Is the theme translation-ready? =
Yes. The theme uses the `bbh-lite` text domain throughout. A POT file is included in the `languages` folder. You can create `.po` and `.mo` files for your language using tools like Poedit. RTL languages are supported with the included `rtl.css` file.

= Does the theme meet accessibility standards? =
BBH Lite includes accessibility-focused features such as keyboard navigation, skip links, and ARIA attributes to enhance usability for a wide range of users.

== Screenshots ==
1. Homepage with navigation, post cards, and footer widgets.
2. Single post with featured image hero layout.
3. Mobile view with full-screen navigation overlay.

== Changelog ==

= 1.0.0 =
Released: May 2026

* Initial release.

= 1.0.1 =

* Improved keyboard accessibility and navigation behavior.
* Refined layout spacing, alignment, and visual consistency.
* Enhanced theme compatibility and compliance updates.

= 1.0.2 =

* Improved multi-level menu keyboard navigation and submenu accessibility.
* Applied prefixing updates for global-scope items.
* Minor code quality, accessibility, and compatibility refinements.

= 1.0.3 =

* Updated Theme URI and licensing information.
* Updated compatibility metadata and documentation.
* Minor refinements and maintenance improvements.

= 1.0.4 =

* Updated theme screenshot.
* Minor CSS refinements and visual improvements.

== Upgrade Notice ==

The latest Version is compatible with previous version, So nothing to worry.

== Credits ==

* **System Fonts:** The theme uses system font stacks (-apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen-Sans, Ubuntu, Cantarell, Helvetica Neue, sans-serif) which are pre-installed on users' devices and require no licensing.
* **Social Icons:** SVG icons for Facebook, Twitter/X, Instagram, LinkedIn, and YouTube are from simpleicons.org (CC0 1.0 Universal License).
* **Navigation Icons:** The hamburger menu icon, search icon, scroll-to-top chevron, and close icons are custom SVG paths created by the theme author (CC0 1.0 Universal License).
* **WordPress:** BBH Lite is built on the WordPress platform (GPLv2 or later). https://wordpress.org/
* **Demo Content:** Theme screenshots and previews are generated using BBH Lite theme layouts and may include decorative shapes and sample text for demonstration purposes only. All assets are used solely for illustrative purposes and are not part of the theme’s functional output.

== Copyright ==

BBH Lite WordPress Theme, (C) 2026 Jahid Shah.
BBH Lite 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.