zyros

# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] v2.2.0 ### 🚀 Community Feedback Implementation & Content Management Evolution This release directly addresses comprehensive community feedback with major improvements to content management, theme system, and developer experience. ### 🔧 Critical Fixes #### 🎨 Dark Theme Text Visibility - **Fixed Invisible Text** - Resolved dark text on dark backgrounds issue - **Smart Color Selection** - Automatic text color based on background luminance - **Enhanced Contrast** - Improved readability across all custom color schemes - **WCAG Compliance** - Better accessibility with proper contrast ratios ### 🚀 Content Management Revolution #### 📁 Multi-File Markdown Support - **Scalable Structure** - New `content/` directory with separate markdown files - **Frontmatter Support** - YAML metadata for posts and pages - **Backward Compatibility** - Existing `site.json` projects continue to work - **Git-Friendly** - Proper diffs, no merge conflicts on large files #### 🛠️ Enhanced Content Tools - **Migration Tools** - Easy transition from site.json to markdown structure - **Content Creation** - CLI tools for creating posts and pages - **Structure Detection** - Automatic detection of content organization - **Dual Support** - Works with both approaches seamlessly ### 📚 Strategic Architecture Improvements #### 🏗️ Future-Ready Architecture - **Dependency Model Planning** - Roadmap for NPM package approach - **Target Audience Focus** - Refined focus on developers as primary audience - **CLI Simplification** - Streamlined commands based on community feedback - **Update Strategy** - Clear path for easier updates and maintenance ### 📖 Enhanced Documentation #### 🔍 Analytics Clarification - **Access Instructions** - Clear documentation for `/analytics` route - **Development vs Production** - Environment-specific access controls - **Privacy First** - GDPR compliant, local-only analytics - **Security Guidelines** - Password protection and environment variables #### 📊 Improved Guides - **Migration Guide** - Step-by-step content structure migration - **Content Management** - Best practices for scalable content - **Theme Customization** - Enhanced theme system documentation ### 🛠️ Developer Experience #### ⚡ Enhanced Content Loader - **Dual Mode Support** - Both site.json and markdown file approaches - **Performance Optimized** - Efficient content discovery and processing - **Error Handling** - Graceful fallbacks and clear error messages - **Type Safety** - Improved TypeScript definitions #### 🎯 CLI Improvements - **Focused Commands** - Emphasis on unique value-add operations - **Content Management** - New tools for markdown-based workflows - **Migration Utilities** - Easy project structure upgrades - **Better Feedback** - Clear success/error messages ### 📋 New Content Structure #### 🗂️ Recommended Organization ``` content/ ├── site.json # Global configuration ├── pages/ # Static pages │ ├── about.md │ └── contact.md └── posts/ # Blog posts ├── 2024-01-15-welcome.md └── 2024-01-20-getting-started.md ``` #### 📝 Frontmatter Example ```yaml --- title: "Getting Started" date: "2024-01-20" category: "tutorial" tags: ["zyros", "getting-started"] author: "Your Name" featured: true --- ``` ### 🔧 Technical Improvements #### 🎨 Smart Color System - **Contrast Detection** - Automatic text color selection - **Accessibility** - WCAG 2.1 compliance improvements - **Theme Compatibility** - Better custom color scheme handling #### 📊 Content Processing - **Multi-Source Support** - Flexible content loading pipeline - **Reading Time Calculation** - Automatic estimation for markdown content - **Tag Management** - Enhanced tag processing and categorization ### 🚀 Migration Tools #### 🔄 Easy Transitions - **Detection** - `detect` command shows current structure - **Migration** - `migrate` command converts site.json to markdown - **Validation** - Verify migration success - **Preservation** - Original files kept for safety ### 📈 Community-Driven Improvements This release directly implements feedback addressing: - **Scalability Concerns** - Multi-file markdown structure - **Update Problems** - Foundation for dependency model - **Target Audience** - Developer-focused approach - **Documentation** - Clarified access and features - **Content Management** - Git-friendly, collaborative approach ### 🔮 Roadmap Foundation #### v3.0 Preparation - **Dependency Architecture** - Planning for NPM package model - **CMS Integration** - Foundation for headless CMS support - **Visual Tools** - Preparation for page builder features - **Performance** - Enhanced monitoring and optimization ### 📚 New Documentation #### 📖 Comprehensive Guides - **ARCHITECTURE_EVOLUTION.md** - Detailed technical improvements - **ROADMAP.md** - Strategic planning and future vision - **Migration documentation** - Step-by-step upgrade guides ### 🤝 Community Impact #### 💡 Feedback Integration - **Dark Theme Fix** - Immediate visibility improvement - **Scalability Solution** - Markdown file structure - **Developer Focus** - Refined target audience - **CLI Streamlining** - Focused command set - **Documentation** - Clearer feature access ## [3.0.0] - 2025-01-20 ### 🚀 Major Release - AI-Powered Features & Enhanced User Experience This is a groundbreaking release that transforms Zyros into an AI-powered static site generator with advanced tools for content creation, SEO optimization, and performance monitoring. ### 🤖 AI-Powered Features #### 🧠 AI Content Generator - **Smart Content Creation** - Generate blog posts, landing pages, product descriptions, and about pages with AI assistance - **Template-Based Generation** - Pre-built templates for different content types with optimized prompts - **Real-time Preview** - See generated content before applying it to your site - **One-Click Integration** - Seamlessly integrate generated content into your site structure - **CLI Support** - Generate content from command line with `zyros-ai generate` #### 📊 SEO Analyzer - **Real-time Analysis** - Instant SEO scoring and optimization suggestions - **Comprehensive Metrics** - Analyze title, description, content, keywords, readability, and structure - **Visual Scoring** - Color-coded scores with detailed breakdown and progress indicators - **Actionable Suggestions** - Specific recommendations with fix instructions - **CLI Integration** - Analyze content files with `zyros-ai seo` #### ⚡ Performance Dashboard - **Core Web Vitals Monitoring** - Track LCP, FID, and CLS with real-time status indicators - **Lighthouse Integration** - Monitor performance, accessibility, best practices, SEO, and PWA scores - **Resource Analysis** - Detailed breakdown of JavaScript, CSS, image sizes, and HTTP requests - **User Experience Metrics** - Track bounce rate, session duration, and pages per session - **Optimization Suggestions** - Prioritized recommendations with impact and effort indicators #### 🎨 Visual Page Builder - **Drag-and-Drop Interface** - Create pages visually without coding - **10 Content Blocks** - Hero, features, testimonials, CTA, gallery, stats, team, FAQ, pricing, contact - **Real-time Preview** - Switch between edit and preview modes instantly - **Property Editor** - Customize block content and styling with intuitive controls - **Export Functionality** - Save created pages directly to your site structure ### 🎨 Enhanced Theme System #### 5 New Themes - **Aurora** - Mystical northern lights with purple-pink gradients and glassmorphism effects - **Autumn** - Warm amber and orange fall-inspired palette with cozy aesthetics - **Cyberpunk** - High-contrast cyan and magenta futuristic design with neon accents - **Sakura** - Delicate pink cherry blossom aesthetic with soft, elegant styling - **Enhanced Existing Themes** - Improved gradients, shadows, and visual effects across all themes #### Advanced Theme Features - **13 Total Themes** - Expanded from 8 to 13 beautiful, professionally designed themes - **Improved Gradients** - Enhanced gradient backgrounds and visual effects - **Better Accessibility** - Improved contrast ratios and readability across all themes - **Smooth Transitions** - Enhanced theme switching with seamless animations ### 🛠️ Developer Experience Improvements #### Enhanced CLI Tools - **New AI Command** - `zyros-ai` command for AI-powered content generation and analysis - **Interactive Prompts** - Beautiful, user-friendly command-line interfaces - **Progress Indicators** - Visual feedback for long-running operations - **Error Handling** - Improved error messages and recovery suggestions #### Component Architecture - **Modular Design** - New components are fully modular and reusable - **TypeScript Integration** - Full type safety for all new AI-powered features - **Performance Optimized** - Lazy loading and efficient rendering for complex UI components - **Accessibility First** - WCAG 2.1 compliant components with keyboard navigation ### 🎯 User Interface Enhancements #### Floating Action Buttons - **AI Content Generator** - Purple gradient floating button for quick content creation - **SEO Analyzer** - Green gradient floating button for instant SEO analysis - **Performance Dashboard** - Blue gradient floating button for performance monitoring - **Visual Page Builder** - Indigo gradient floating button for visual page creation #### Improved Analytics Dashboard - **Enhanced Visualizations** - Better charts, progress bars, and data presentation - **Real-time Updates** - Live data updates without page refresh - **Export Functionality** - Download analytics data in JSON format - **Mobile Responsive** - Fully optimized for mobile and tablet viewing ### 🔧 Technical Improvements #### Performance Optimizations - **Code Splitting** - Improved bundle splitting for faster initial load times - **Lazy Loading** - Components load only when needed - **Memory Management** - Optimized memory usage for large sites - **Build Performance** - Faster build times with improved optimization #### Security Enhancements - **Input Validation** - Enhanced validation for user inputs and file uploads - **XSS Protection** - Improved cross-site scripting protection - **Content Security Policy** - Better CSP headers for enhanced security - **Dependency Updates** - All dependencies updated to latest secure versions ### 📱 Mobile Experience #### Responsive Design - **Mobile-First AI Tools** - All new AI features fully optimized for mobile devices - **Touch Interactions** - Improved touch handling for drag-and-drop functionality - **Adaptive UI** - Interface adapts intelligently to different screen sizes - **Performance** - Optimized for mobile performance and battery life ### 🌐 Accessibility Improvements #### WCAG 2.1 Compliance - **Keyboard Navigation** - Full keyboard accessibility for all new features - **Screen Reader Support** - Comprehensive ARIA labels and descriptions - **Color Contrast** - Enhanced contrast ratios across all themes - **Focus Management** - Improved focus handling and visual indicators ### 📚 Documentation Updates #### Comprehensive Guides - **AI Tools Documentation** - Complete guide for using AI-powered features - **Theme Customization** - Enhanced theme customization documentation - **Performance Optimization** - Best practices for site performance - **SEO Guide** - Complete SEO optimization guide ### 🔄 Migration Notes #### Backward Compatibility - **No Breaking Changes** - All existing functionality preserved - **Automatic Upgrades** - New features available immediately upon update - **Optional Features** - All AI features are opt-in and don't affect existing sites - **Theme Compatibility** - Existing themes continue to work unchanged #### New Features Access - **Floating Buttons** - New AI tools accessible via floating action buttons - **CLI Commands** - Access AI tools via new `zyros-ai` command - **Theme Selection** - 5 new themes available in theme switcher - **Performance Monitoring** - Built-in performance dashboard available ### 🎉 What's Next This release establishes Zyros as the most advanced static site generator with AI-powered features. Future releases will focus on: - **AI Model Integration** - Connect with real AI APIs for content generation - **Advanced Analytics** - More detailed user behavior tracking - **Collaboration Features** - Multi-user editing and collaboration tools - **E-commerce Integration** - Built-in e-commerce capabilities ## [2.1.4] - 2025-06-24 ### 🔧 Critical Fixes & Improvements This release addresses critical command termination issues and completes the template system implementation. ### Fixed #### 🐛 Command Termination Issues - **CLI Command Hanging** - Fixed all CLI commands not terminating properly after completion - **Process Exit Handling** - Added proper `process.exit()` calls to all script functions - **User Experience** - Commands now immediately return control to the user after completion - **Cross-platform Compatibility** - Improved Windows PowerShell compatibility #### 🎨 Template System Completion - **Template Discovery** - Fixed template listing and discovery functionality - **Template Application** - Ensured all templates apply correctly during project initialization - **Template Validation** - All 5 templates now properly configured and tested ### Added #### 📦 Complete Template System - **Business Template** - Professional business website with landing page, services, team profiles - **Documentation Template** - Technical documentation site with sidebar navigation, code highlighting - **Minimal Template** - Ultra-clean minimal design focused on typography - **Portfolio Template** - Showcase template with project galleries, about section, contact form - **Enhanced Default Template** - Improved default blog template with better content #### 🛠️ Enhanced CLI Experience - **Immediate Feedback** - All commands now provide clear completion status - **Proper Termination** - No more hanging commands or user confusion - **Consistent Behavior** - All CLI operations follow the same termination pattern - **Error Handling** - Improved error reporting with proper exit codes ### Enhanced #### 🎯 Reliability Improvements - **Command Execution** - All CLI commands now execute and terminate reliably - **Template Initialization** - Project creation with templates works consistently - **Validation Process** - Content validation completes properly - **Build Process** - Build operations terminate correctly after completion #### 📊 Testing & Validation - **Comprehensive Testing** - All CLI commands tested for proper termination - **Template Verification** - All 5 templates verified working correctly - **Cross-platform Testing** - Tested on Windows PowerShell environment - **Error Scenarios** - Proper handling of error conditions with appropriate exit codes ### Technical Details #### 🔧 Script Modifications - **scripts/template.js** - Added process.exit() to all template functions - **scripts/validate.js** - Added proper termination for successful validation - **scripts/optimize.js** - Fixed optimization command termination - **scripts/deploy.js** - Added exit handling for all deployment functions - **scripts/build.js** - Added successful build termination - **scripts/cli.js** - Fixed all CLI utility function terminations #### 📁 Template Structure - **Complete Configurations** - All templates have proper template.json and site.json - **Content Validation** - All template content passes validation - **Theme Integration** - Templates properly integrate with theme system - **Initialization Testing** - All templates tested with zyros init command ### Migration Notes - **No Breaking Changes** - All existing functionality preserved - **Automatic Improvements** - Command termination fixes apply automatically - **Template Availability** - All 5 templates now available for use - **Backward Compatibility** - Existing projects continue to work unchanged ## [2.0.0] - 2025-05-30 ### 🎉 Major Release - NPM Package Ready! This is a major release that transforms zyros into a fully-featured npm package with comprehensive CLI tools and enhanced functionality. ### Added #### 📦 NPM Package & CLI - **Global installation support** - Install with `npm install -g zyros` - **Comprehensive CLI tool** - Full command-line interface with `zyros` command - **Project initialization** - Create new projects with `zyros init` - **Template system** - Multiple starter templates for different use cases - **Content management CLI** - Create, list, delete, and manage content from terminal #### 🎨 Templates & Themes - **Multiple templates** - Default, portfolio, documentation, business, minimal - **Template management** - List, apply, and create custom templates - **Enhanced theme system** - 8 beautiful built-in themes - **Custom theme support** - Create and use custom themes #### 🔍 Validation & Optimization - **Content validation** - Validate site structure and content integrity - **Image optimization** - Automatic image compression and WebP generation - **Asset optimization** - CSS and JS minification - **Performance optimization** - Built-in performance enhancements #### 🚀 Deployment & DevOps - **One-click deployment** - Deploy to Vercel, Netlify, GitHub Pages, AWS S3 - **Deployment configuration** - Automatic config generation for platforms - **Build optimization** - Enhanced build process with RSS and sitemap generation - **Environment support** - Development and production environment handling #### 🛠️ Developer Experience - **TypeScript definitions** - Full type safety and IntelliSense support - **Enhanced CLI** - Beautiful terminal output with colors and spinners - **Project validation** - Comprehensive project structure validation - **Error handling** - Improved error messages and debugging #### 📊 Analytics & SEO - **Enhanced analytics** - Improved privacy-first analytics system - **SEO optimization** - Advanced meta tags, Open Graph, and structured data - **RSS feed generation** - Automatic RSS feed creation - **Sitemap generation** - SEO-friendly XML sitemaps ### Enhanced #### 🎯 Core Features - **Improved build system** - Faster builds with better optimization - **Enhanced search** - Better search performance and accuracy - **Mobile optimization** - Improved mobile experience and performance - **Accessibility** - Enhanced keyboard navigation and screen reader support #### 📝 Content Management - **Rich content support** - Enhanced Markdown rendering with more features - **Content statistics** - Detailed analytics about your content - **Reading time calculation** - Automatic reading time estimation - **Content organization** - Better categorization and tagging system #### 🎨 User Interface - **Improved animations** - Smoother transitions and micro-interactions - **Better responsive design** - Enhanced mobile and tablet experience - **Theme switching** - Improved theme switching with better persistence - **Loading states** - Better loading indicators and skeleton screens ### Fixed #### 🐛 Bug Fixes - **Build process** - Fixed various build-related issues - **Theme switching** - Resolved theme persistence issues - **Search functionality** - Fixed search indexing and performance - **Mobile navigation** - Improved mobile menu behavior - **Image handling** - Better image loading and optimization #### 🔧 Technical Improvements - **Memory usage** - Optimized memory consumption during builds - **Bundle size** - Reduced JavaScript bundle size - **CSS optimization** - Improved CSS generation and minification - **Error boundaries** - Better error handling and recovery ### Changed #### 💔 Breaking Changes - **Package structure** - Reorganized for npm distribution - **CLI interface** - New command structure (old scripts still work) - **Configuration format** - Enhanced site.json schema (backward compatible) - **Build output** - Changed from `.next` to `dist` directory #### 🔄 Migrations - **Automatic migration** - Existing projects are automatically updated - **Backward compatibility** - Old configurations continue to work - **Gradual adoption** - New features are opt-in ### Security #### 🔒 Security Improvements - **Dependency updates** - Updated all dependencies to latest secure versions - **Input validation** - Enhanced validation for user inputs - **XSS protection** - Improved cross-site scripting protection - **Content Security Policy** - Better CSP headers for deployed sites ## [1.0.0] - 2025-05-01 ### Added - Initial release of zyros - JSON-based content management - 8 beautiful themes - Markdown support with syntax highlighting - Static site generation with Next.js - Responsive design - Search functionality - Analytics dashboard - Social sharing - Newsletter subscription - Reading progress indicator - Table of contents - Copy code blocks - Theme switching ### Features - **Core functionality** - Basic static site generation - **Theme system** - 8 built-in themes - **Content management** - JSON-based content system - **Search** - Basic search functionality - **Analytics** - Privacy-first analytics - **Social features** - Sharing and newsletter --- ## Upgrade Guide ### From 1.x to 2.0 1. **Install the new version**: ```bash npm install -g zyros ``` 2. **Update your project**: ```bash cd your-project zyros validate ``` 3. **Use new CLI commands**: ```bash # Old way npm run content:create # New way zyros content create ``` 4. **Update build scripts** (optional): ```json { "scripts": { "dev": "zyros dev", "build": "zyros build", "deploy": "zyros deploy vercel" } } ``` ### Migration Notes - All existing projects continue to work without changes - New CLI commands provide enhanced functionality - Old npm scripts are still supported - Configuration format is backward compatible - Build output directory changed from `.next` to `dist` --- ## Support #SOON - 📖 [Documentation](https://github.com/zyrasoftware/zyros) - 💬 [Community](https://github.com/zyrasoftware/zyros/discussions) - 🐛 [Issues](https://github.com/zyrasoftware/zyros/issues) - 📧 [Email](mailto:zyrasoftwaredev@gmail.com)