=== Forma Studio ===
Contributors: formastudio
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 8.0
Version: 1.2.1
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

An architecture and interiors theme with expressive editorial layouts and native WordPress block editing.

== Description ==
Forma Studio includes 13 native block patterns, four coherent color palettes, four local font pairings, a larger reading scale, three header and footer arrangements, individual page and project templates, optional sticky navigation, search, social links, gallery navigation, image comparison, readable journals, archives and comments. All theme assets load locally. The theme runs independently; Forma Core is an optional companion for portable project content and enquiries.

== Installation ==
1. In Appearance → Themes → Add New → Upload Theme, upload forma-studio-1.2.1.zip and activate.
2. Create a page, open the block inserter → Patterns → Forma Studio, and choose a layout.
3. Set your homepage in Settings → Reading. Use Appearance → Forma design for the guided setup, or Appearance → Customize to preview choices before publishing. Set menus and logo with WordPress controls.
4. Replace concept imagery and copy with your own material. Publish only after reviewing your content and links.

Activation never creates or publishes pages, imports media, changes menus or replaces your homepage. Optional companion content stays in WordPress when changing themes. Regular pages and posts do not need a companion plugin.

== Updating ==
Back up your files and database, test the 1.2.1 ZIP on staging, then upload it using WordPress theme replacement. Keep custom template changes in a child theme. The theme has no separate updater or remote service.

== Design and editing ==
The theme is a classic hybrid theme with native block editing and theme.json, not a Full Site Editing theme. Header, footer, typography and site-wide presentation are controlled in Appearance → Forma design or the Customizer. Pages and optional projects can override their layout in the editor Template setting. Native patterns contain normal editable blocks; the journal pattern updates from published posts automatically. The optional Forma Core Projects block keeps project selections current. Static image cards remain independently editable.

The design settings page can export/import validated JSON containing only its presentation preferences. Imports never run code or create content. Saving, importing or resetting there keeps one previous design for restoration. Customizer changes are not added to that one-step history. Menu assignments, logos, media, content and accounts are excluded from settings exports. Contact and social destinations should be reviewed when moving settings between sites.

Four semantic palettes stay synchronized between the editor and website; the accent is adjusted for text contrast against page and panel surfaces. Authors can still choose arbitrary block colors, so review your own content for readability. All font choices use local device fonts; their precise appearance varies by platform.

Project featured images and native image links open a local preview with previous/next controls, image count, arrow keys, Home/End and Escape. On touch devices horizontal swipes move between images. The comparison pattern is a presentation enhancement of two native images: without JavaScript they appear side by side; with JavaScript a keyboard-operated slider reveals the two views. Both descriptions remain available.

== Privacy ==
The theme does not collect visitor data, contact external services or add tracking. Gallery previews, comparison sliders, settings file reading and the mobile menu run locally without storing or sending choices. Comments and search use WordPress facilities.

== Assets and licensing ==
Copyright (C) 2026 Forma Studio. Licensed under the GNU General Public License v2 or later.

Theme code, styles, scripts, patterns and bundled original concept images: GPLv2 or later. Fonts use the visitor's installed system fonts. Bundled media were generated specifically for this fictional architecture concept and do not document constructed projects, commissions or a real practice. Image files: assets/media/courtyard-house.webp, courtyard-gallery.webp, interior.webp, interior-gallery.webp, pavilion.webp and pavilion-gallery.webp. The comparison example shows two imagined viewpoints, not evidence of a real before-and-after renovation.

== Changelog ==

= 1.2.1 =
* Coordinated release with reliable administrator access to Guided setup and Studio controls, and a linked project hero for complete gallery navigation.

= 1.2.0 =
Guided design controls; coherent four-palette editing; local typography and reading scale; configurable headers, footers and content templates; secure design transfer and restoration; eight additional native patterns; keyboard gallery navigation and native-image comparison; stronger small-text contrast and RTL presentation.

= 1.1.0 =
Editorial design, page and journal templates, responsive navigation, native block patterns and independent operation.
