=== Immersa Builder ===
Contributors: codefreex
Tags: blog, e-commerce, portfolio, one-column, two-columns, left-sidebar, right-sidebar, wide-blocks, block-patterns, block-styles, custom-background, custom-colors, custom-logo, custom-menu, editor-style, featured-images, footer-widgets, rtl-language-support, sticky-post, theme-options, threaded-comments, translation-ready
Requires at least: 6.6
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Responsive business and blog theme with Customizer design controls, block patterns, WooCommerce styling, and optional starter templates through Immersa Core.

== Description ==

Immersa Builder is a flexible WordPress theme for business websites, blogs, portfolios, and WooCommerce-ready projects. It focuses on frontend presentation: responsive layouts, clean typography, header and footer presets, sidebar options, color controls, button styling, social links, post layouts, and editor-friendly block styles.

The theme works without any plugin. If you want guided setup, starter templates, reusable blocks, and optional AI writing tools, you can manually install the recommended Immersa Core Starter Templates & AI plugin from the WordPress.org plugin directory:

https://wordpress.org/plugins/immersa-core-starter-templates-ai/

= Theme Features =

* Responsive layouts for desktop, tablet, and mobile screens.
* Customizer controls for colors, typography, header, footer, layout, blog display, buttons, and social links.
* Header presets for default, centered, and minimal navigation layouts.
* Footer presets with widget areas and optional social links.
* Blog list and grid display options.
* Block editor support for wide and full-width blocks, block styles, and bundled block patterns.
* WooCommerce styling for shop, product, cart, checkout, and account screens.
* Translation-ready text domain: `immersa-builder`.
* RTL stylesheet support through WordPress core RTL handling.
* System font stacks only; the theme does not load remote font files.

= Recommended Companion Plugin =

Immersa Core Starter Templates & AI is optional and recommended for users who want more site-building tools. It provides starter templates, guided setup, block patterns, coming soon layouts, Elementor-ready import support, global style presets, and optional AI writing tools.

The theme does not install, activate, update, or download plugins. To use Immersa Core, go to Plugins > Add New in your WordPress admin and search for "Immersa Core Starter Templates & AI", or open the WordPress.org listing linked above.

= Customizer Sections =

* Colors: primary, secondary, accent, text, background, border, link, and alternate background colors.
* Typography: local/system font stack choices and base font size.
* Header: preset, optional CTA button, CTA style, CTA size, and optional custom CTA colors.
* Footer: preset, copyright text, minimal-footer alignment, and widget areas.
* Layout: container width with `px`, `vw`, or `%` units, sidebar position, and layout style preset.
* Blog: list or grid layout, posts per page, excerpt length, featured image toggle, and post meta toggle.
* Buttons: border radius, padding, and text color.
* Social Links: configurable profile URLs shown in the header, footer, both, or neither.

= Requirements =

* WordPress 6.6 or higher.
* PHP 7.4 or higher.
* WooCommerce is optional and only needed for store features.
* Immersa Core Starter Templates & AI is optional and only needed for starter templates, guided setup, block extras, and optional AI tools.

== Installation ==

1. In your WordPress admin, go to Appearance > Themes > Add New.
2. Search for "Immersa Builder".
3. Click Install and then Activate.
4. Open Appearance > Customize to adjust colors, typography, layout, header, footer, and blog settings.
5. Optional: install Immersa Core Starter Templates & AI manually from Plugins > Add New if you want starter templates, guided setup, and optional AI tools.

== Frequently Asked Questions ==

= Does Immersa Builder require a plugin? =

No. The theme works on its own. Immersa Core Starter Templates & AI is recommended only for optional starter templates, setup flows, block extras, and AI tools.

= Does the theme install or activate plugins? =

No. The theme only links to the public WordPress.org listing for the recommended companion plugin. Plugin installation and activation are manual user actions.

= Is Immersa AI still a separate plugin? =

No. AI tools are part of the Immersa Core Starter Templates & AI plugin. The theme no longer recommends a separate Immersa AI plugin.

= Does the theme contact Themefreex or any remote service? =

No. The theme does not contact remote services for starter templates, AI, plugin registries, or font files. Optional service-connected features are handled by the companion plugin after the user installs and configures it.

= Can I use starter templates? =

Yes, by manually installing the optional Immersa Core Starter Templates & AI plugin from WordPress.org. The theme itself provides the frontend presentation layer.

= Does it work with the block editor? =

Yes. Immersa Builder supports the WordPress block editor, wide and full-width alignment, block styles, and bundled theme patterns.

= Does it work with WooCommerce? =

Yes. WooCommerce is optional. When WooCommerce is active, the theme styles shop, product, cart, checkout, and account screens.

= Can I translate Immersa Builder? =

Yes. User-facing strings use WordPress translation functions with the `immersa-builder` text domain.

== Changelog ==

= 1.0.5 =
* Bumped theme version to 1.0.5.
* Added complete third-party asset attribution and license links, including the bundled screenshot.

= 1.0.4 =
* Fixed long page, post, archive, navigation, block, and WooCommerce titles so they wrap without creating horizontal overflow.
* Added complete third-party asset attribution and license links, including the bundled screenshot.
* Replaced the theme screenshot with a self-created Immersa Builder UI preview.

= 1.0.3 =
* Removed the custom plugin installer, ZIP download flow, plugin registry request, activation AJAX handlers, and required-plugin wording.
* Replaced plugin installation prompts with a manual recommendation link to the WordPress.org listing for Immersa Core Starter Templates & AI.
* Removed theme-owned performance controls and performance behavior from the Customizer and frontend scripts.
* Removed remote Google Fonts loading and switched typography choices to local/system font stacks.
* Removed theme-side custom block registration so block extras live in the companion plugin.
* Removed theme-side Elementor option mutation and cache-clearing behavior.
* Improved mobile menu keyboard trapping while the menu is open.
* Improved skip-link contrast and admin-bar positioning.
* Underlined links in post content, excerpts, comments, and text widgets.
* Updated the theme screenshot to show the frontend only.
* Updated public copy for the merged Core + AI companion plugin.

= 1.0.2 =
* Header CTA rendering improvements.
* Blog layout, footer, Elementor styling, and Customizer improvements.
* Social link and layout styling improvements.

= 1.0.1 =
* Added social links, button styling controls, and advanced color controls.
* Improved starter-template compatibility with the companion plugin.

= 1.0.0 =
* Initial release.

== Screenshots ==

1. Immersa Builder frontend homepage preview.

== Copyright ==

Immersa Builder WordPress Theme, Copyright 2026 Codefreex
Immersa Builder is distributed under the terms of the GNU GPL v2 or later.

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.

This theme bundles the following third-party resources:

=== Inline SVG Social Icons ===

Feather Icons
Copyright (c) 2013-2023 Cole Bemis and Feather contributors.
License: MIT License, https://github.com/feathericons/feather/blob/master/LICENSE
Source: https://github.com/feathericons/feather
Used icons: Facebook, Instagram, LinkedIn, YouTube, and GitHub SVG paths in `inc/footer-render.php`.

Simple Icons
Copyright: Simple Icons Contributors.
License: CC0 1.0 Universal, https://github.com/simple-icons/simple-icons/blob/develop/LICENSE.md
Source: https://github.com/simple-icons/simple-icons
Used icons: X / Twitter, TikTok, Pinterest, and WordPress SVG marks in `inc/footer-render.php`.

Social-network names and marks are trademarks of their respective owners. They are used only to identify configured social-link destinations.

=== CSS Reset Foundation ===

Modern CSS Reset
Copyright (c) 2019 Andy Bell and contributors.
License: MIT License, https://github.com/hankchizljaw/modern-css-reset/blob/master/LICENSE
Source: https://github.com/hankchizljaw/modern-css-reset
Used in: adapted reset foundation at the top of `assets/css/base.css`.

=== Theme-Owned Assets ===

Theme PHP, CSS outside the documented reset foundation, JavaScript, block patterns, template parts, and original SVG modifications: Copyright 2026 Codefreex, licensed GPLv2 or later.

`screenshot.png`: Copyright 2026 Codefreex, licensed GPLv2 or later. It is a self-created Immersa Builder UI preview and contains no stock photography, externally sourced image, or imported raster asset.

=== Runtime Dependencies Not Bundled ===

System fonts are supplied by the user's operating system. The theme does not bundle font files and does not request remote web-font files.

The Customizer preview uses WordPress core's registered jQuery dependency. No jQuery file is bundled with this theme.

Full attribution and license links are also available in `THIRD-PARTY-LICENSES.md` in the theme directory.
