Nexus Blocks

=== Nexus Blocks === Contributors: webclyde Tags: gutenberg, blocks, page builder, advanced blocks, design system Requires at least: 6.4 Tested up to: 6.6 Requires PHP: 8.1 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced Gutenberg blocks with Elementor Pro-level design controls. Zero render-blocking CSS, scoped per-block styles, and a full global design token system.

== Description ==

Nexus Blocks brings Elementor Pro-level design control to the native WordPress block editor — without the performance overhead of a page builder.

= Phase 1 Blocks (16 blocks) =

• Advanced Heading — Full typography control, gradient text, text stroke, SVG highlight shapes
• Advanced Text — Multi-column body copy with drop cap and column rules
• Advanced Image — CSS filters, hover overlays, shape masks, lightbox
• Advanced Button — Gradient backgrounds, hover animations, icon support, ripple effects
• Icon — Scalable SVG/Font Awesome icons with shape backgrounds, tooltips
• Divider — Horizontal rule with optional text or icon center element
• Spacer — Responsive vertical spacer with optional background
• Icon Box — Feature cards with icon, title, description, hover effects
• Image Box — Team/product cards with image, title, description
• Icon List — Styled lists with per-item icon and color overrides
• Counter — Count-up animation on scroll with odometer mode
• Progress Bar — Animated fill bars with gradient support
• Star Rating — Visual rating with star, heart, circle, or diamond icons
• Tabs — Switchable content panels with URL hash support
• Accordion — FAQ accordion with schema.org markup output
• Alert / Notice — Dismissible notifications with cookie persistence

= Core Features =

• Zero render-blocking CSS — each block outputs only the CSS it needs, scoped with a unique block ID
• Global Design Token System — define colors, typography, and spacing tokens shared across all blocks
• No jQuery — vanilla JS and React only
• FSE Compatible — all blocks work in Full Site Editing templates
• Accessibility — WCAG 2.1 AA compliant on every block
• Responsive Controls — independent values for Desktop, Tablet, and Mobile

== Installation ==

1. Upload the nexus-blocks folder to /wp-content/plugins/
2. Activate the plugin through the Plugins menu in WordPress
3. Open any post or page in the block editor — all Nexus blocks appear in the Nexus Blocks category

= Building from Source =

cd nexus-blocks
npm install
npm run build

== Frequently Asked Questions ==

= Does this replace my existing page builder? = No. Nexus Blocks extends the native WordPress block editor (Gutenberg). It works alongside your existing blocks and themes.

= Does it work with Full Site Editing? = Yes. All Phase 1 blocks are FSE-compatible and can be used in site templates.

= What happened to my blocks after an update? = Nexus Blocks uses a deprecated attribute system. Old block attributes are migrated automatically when you open a post in the editor.

= Is WooCommerce supported? = WooCommerce blocks are planned for Phase 3. The plugin does not conflict with WooCommerce.

== Screenshots ==

1. Advanced Heading block with gradient text and SVG highlight shape
2. Icon Box grid — feature cards with hover lift effect
3. Global Design Panel — color tokens and typography presets
4. Accordion block with FAQ schema output

== Changelog ==

= 1.0.0 =

• Initial release — all 16 Phase 1 blocks
• Global Design Token Panel (Colors, Typography, Spacing, Custom CSS)
• Scoped per-block CSS architecture
• Frontend: count-up counter, progress bar animations, tabs, accordion, alert dismiss

== Upgrade Notice ==

= 1.0.0 = Initial release.