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
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

• Sage by Roots
• Tailwind CSS
• Laravel
• Vite

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