=== Maneuvrez Portfolio ===
Contributors: abuhurarrah
Requires at least: 6.6
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A fast native block theme for portfolio and service-business websites.

== Description ==

Maneuvrez Portfolio is a native WordPress block theme for professional portfolio, freelance, consultant, studio, and service-business websites.

It is built for people who need to present work, explain services, publish case studies, write articles, and guide visitors toward a clear next step. The theme uses WordPress core blocks, full-site editing, editable templates, reusable patterns, style variations, system fonts, and a small theme stylesheet.

The included patterns cover common portfolio and service-business sections:

* Portfolio and service page heroes.
* About, profile, skills, technology, and experience sections.
* Services, capabilities, process, pricing-intent, and FAQ sections.
* Selected work, project grids, featured projects, compact portfolio cards, case-study grids, proof, and testimonial layouts.
* Blog, archive, latest posts, featured insight, search, no-results, and 404 layouts.
* Header, footer, newsletter-compatible, form-compatible, and contact call-to-action layouts.

The theme is intended to stay lightweight and editable. It does not include analytics, tracking, contact-form processing, lead storage, custom post types, custom blocks, SEO metadata systems, schema generators, redirects, remote fonts, icon fonts, third-party images, or page-builder dependencies.

== Getting Started ==

After activation, open Appearance > Editor to customize the site header, footer, templates, navigation, global styles, and page layouts.

Start with the included patterns when building:

* A portfolio homepage.
* A professional service page.
* A case-study page.
* An about or skills page.
* A blog, archive, search, or 404 experience.
* A contact-focused call to action.

Patterns are starter layouts. Replace placeholder text with your own content, update navigation labels, and add your own images through WordPress media blocks where needed.

== Installation ==

Install the theme from the WordPress admin area or by uploading the theme ZIP file.

After activation:

* Open Appearance > Editor.
* Review the header, footer, navigation, templates, and global styles.
* Insert or edit patterns for the pages you need.
* Replace placeholder copy with your own work, services, proof, articles, and calls to action.
* Add forms, SEO controls, analytics, or multilingual routing through WordPress core features or compatible plugins if your site needs them.

== Customization ==

The theme supports WordPress global styles and style variations. Use the Site Editor to adjust colors, typography, spacing, templates, and template parts without editing code.

The theme also registers project-card block styles for core Group and Post Template blocks. These styles cover default, minimal, bordered, elevated, image-overlay, description-visible, and image-zoom card treatments. They are visual styles only and do not create a custom project content type or project metadata system.

Portfolio patterns include manual card layouts and Query Loop layouts that work with normal posts by default. They are starter sections only; the theme does not create portfolio records, project metadata, filtering logic, or custom content storage.

The theme also includes presentation-only compatibility templates for a `project` post type if one is registered by another plugin. These templates are disabled by default and can be enabled from Appearance > Customize > Maneuvrez Portfolio Controls. When enabled, they style project archives and single project entries with core blocks, but the theme does not register the post type, taxonomies, metadata, rewrite rules, REST controllers, admin screens, or project database options.

The theme includes a fixed appearance dock for System, Light, and Dark modes. First-time visitors use their operating-system preference. If a visitor chooses a mode, the choice is stored locally in that browser with the `maneuvrez-portfolio-color-scheme` localStorage key. The theme does not store this preference in the WordPress database and does not use AJAX, REST, cookies, accounts, or external services for appearance mode.

Admins can open Appearance > Customize > Maneuvrez Portfolio Controls to show or hide the appearance dock, the back-to-top button, the optional reading progress bar, and the optional project compatibility templates.

When JavaScript is unavailable, the site remains usable and follows the browser or operating-system color-scheme preference through CSS.

The theme uses system fonts by default, so it does not request remote font files. If you add custom fonts, third-party images, analytics, forms, or SEO features through plugins or custom work, review those additions separately for licensing, privacy, performance, and accessibility.

== Recommended Use ==

Maneuvrez Portfolio works best for:

* Independent professionals.
* Freelancers and consultants.
* Developers, designers, and technical specialists.
* Small studios and service agencies.
* Portfolio and editorial sites that need a clean native block-theme foundation.

For enquiry forms, use WordPress core blocks where suitable or a dedicated form plugin. For SEO metadata, schema, redirects, analytics, multilingual routing, or custom content types, use WordPress core features or a compatible plugin.

== Accessibility and Internationalization ==

The theme is built with semantic templates, visible focus styles, reduced-motion support, translation-ready PHP strings, RTL-aware layout choices, and a generated translation template.

The theme does not currently claim the accessibility-ready tag. Site owners should still review their own content, images, color choices, plugin output, navigation, and forms for accessibility.

== Screenshot ==

The bundled screenshot shows the theme's dark default style with a header, navigation, service-focused hero section, call-to-action buttons, and capability cards.

The screenshot was captured from a local WordPress preview of the theme at 1200x900 pixels. It does not contain third-party imagery, logos, client work, ratings, testimonials, or external assets.

== Frequently Asked Questions ==

= Does this theme include a contact form? =

No. The theme includes layout patterns where a site owner can insert a form block from WordPress core or a compatible plugin. It does not process or store enquiries.

= Does this theme include SEO settings? =

No. The theme provides semantic templates and readable layouts, but SEO metadata, schema, redirects, analytics, and advanced search appearance controls belong in WordPress core or plugins.

= Does this theme include custom post types? =

No. The theme uses standard WordPress content and core blocks. Portfolio or testimonial custom post types should be provided by a plugin if a site needs durable structured content.

= How do the project compatibility templates work? =

The theme bundles `archive-project.html` and `single-project.html` for sites that already use a plugin-provided public `project` post type. These templates are disabled by default. To use them, open Appearance > Customize > Maneuvrez Portfolio Controls and enable project compatibility templates. When enabled, WordPress can use the theme layout for `/project/` archives and individual project entries. If your plugin uses a different post type slug, such as `portfolio` or `case_study`, these templates will not apply.

= Does this theme include bundled fonts or images? =

No. The theme uses system fonts and does not bundle third-party media assets.

= How does the appearance mode work? =

The theme supports System, Light, and Dark modes. System mode follows the visitor's operating-system preference. Explicit visitor choices are stored only in that browser using localStorage and can be changed from the fixed appearance dock.

= Can I hide the floating controls? =

Yes. Use Appearance > Customize > Maneuvrez Portfolio Controls to toggle the appearance dock, back-to-top button, reading progress bar, and project compatibility templates.

= Can I use it with multilingual plugins? =

The theme is translation-ready and avoids hardcoded language or direction assumptions. Multilingual routing, language switchers, and translated URL management should be handled by WordPress core or a multilingual plugin.

== Changelog ==

= 1.0.1 =

* Updated WordPress.org theme tags.
* Fixed proof stats band spacing in wide layouts.
* Refreshed the theme screenshot with the appearance control visible.

= 1.0.0 =

* Initial WordPress.org release candidate.
* Added native block templates, template parts, style variations, and portfolio/service-business patterns.
* Added project-card block styles for core Group and Post Template blocks.
* Added expanded portfolio grid, featured project, case-study grid, masonry-inspired, and view-all-projects patterns.
* Added presentation-only compatibility templates for plugin-provided project archives and single project entries.
* Added accessible System, Light, and Dark appearance mode with local browser preference storage.
* Added Customizer controls for optional floating theme controls.
* Added translation template and RTL-readiness improvements.
* Completed security, performance, accessibility, compatibility, SEO-supportive, RTL, and release-readiness reviews.

== Resources ==

Maneuvrez Portfolio WordPress Theme, Copyright 2026 Abu Hurarrah.
License: GNU General Public License v2 or later.
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bundled resources:

* Theme PHP, HTML, CSS, JSON, and pattern content: Abu Hurarrah, GPLv2 or later.
* `screenshot.png`: Abu Hurarrah, GPLv2 or later. Captured from the theme's local WordPress preview.
* No third-party fonts, scripts, images, icon fonts, or media assets are bundled.

== Copyright ==

Maneuvrez Portfolio WordPress Theme, Copyright 2026 Abu Hurarrah.
Maneuvrez Portfolio is distributed under the terms of the GNU GPL.
