=== 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.3
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.

== Upgrade Notice ==

= 1.0.0 =
Initial stable release. No upgrade required.

== 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 may include placeholder text, sample imagery, and demonstration layouts created for illustrative purposes only.

== 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.