README

Nynaeve

Design better, build faster, deliver results. Nynaeve is a modern WordPress theme built on Sage 11 with reusable custom blocks using WordPress native tools and the Roots.io stack.

What We Do

Custom Block Development: Reusable, professional blocks built with WordPress native tools
E-Commerce Solutions: WooCommerce integration with flexible quote-based systems
Performance First: Optimized for Core Web Vitals with modern build tools
Responsive Design: Mobile-first approach with Tailwind CSS
Developer Friendly: Built on Sage 11 and Acorn (Laravel for WordPress)

Features

17 Professional Custom Blocks - CTAs, hero banners, content layouts, pricing tables, carousels, reviews, and more
InnerBlocks Architecture - Built with native WordPress blocks for maximum flexibility
Modern Build Tools - Vite with HMR, Tailwind CSS 4, Laravel Blade templates
WooCommerce Ready - Quote mode, catalog mode, or standard e-commerce
Fully Customizable - No hardcoded styles, all styling via WordPress block toolbar
Production Ready - Semantic HTML, accessible, responsive by default

Custom Blocks

The theme includes these professionally-designed blocks (all using InnerBlocks for maximum flexibility):

Content & Layout

About Block - Two-column layout with profile image and about text
Content Image Text Card - Flexible content cards with images and text
Multi-Column Content - Multi-column layout with customizable content
Two-Column Card - Two-column card layout for features or services
Feature List Grid - Grid layout for feature listings

Call-to-Actions

CTA Block Blue - Blue call-to-action section with centered content and button
CTA Columns - Multi-column CTA cards with customizable styling
Page Heading Blue - Blue page header with centered heading

Social Proof

Review Profiles - Customer reviews with circular profile images (3-column layout)
Testimonial Grid - Testimonial carousel with metrics and navigation controls

E-Commerce & Pricing

Pricing - Two-column pricing comparison table
Pricing Tiers - Three-column pricing tiers with featured option

Interactive

Carousel - Image carousel with Slick.js integration
FAQ - Frequently asked questions with accordion functionality
Related Articles - Related articles section with tag-based filtering

All blocks are fully responsive, accessible, and integrate seamlessly with WordPress's native block editor.

Requirements

WordPress 6.6 or later
PHP 8.2 or later
Node.js 16 or later
Composer

Quick Start

# Navigate to theme directory
cd site/web/app/themes/nynaeve

# Install dependencies
composer install && npm install

# Start development server with HMR
npm run dev

# Build for production
npm run build

Documentation

Resource	Description
Developer Guide	Development commands, architecture, and workflows
Blocks Overview	Complete block library with usage examples
WooCommerce Integration	Quote mode, catalog mode, and configuration
Pattern to Block Guide	Convert patterns to native blocks
CLAUDE.md	AI assistant guidance and project context
CHANGELOG.md	Version history and updates

Technical Stack

Sage 11 - Modern WordPress theme framework
Acorn 5 - Laravel-powered framework for WordPress
Vite - Lightning-fast build tool with HMR
Tailwind CSS 4 - Utility-first CSS with custom design system
Laravel Blade - Powerful templating engine
React/JavaScript - Custom blocks using imagewize/sage-native-block package

Browser Support

Latest versions of Chrome, Firefox, Safari, and Edge

License

MIT

Credits

Design Credits

Flower Icon: Adapted from Remix Icon via Blade UI Kit
- Original: ri-flower-fill by Remix Icon (Apache 2.0 License)
- Colors customized to Nynaeve theme palette (#017cb6 primary blue)
Laptop Photo: Photo by Joshua Ng on Unsplash

imagewize / nynaeve

Maintainers

Details