A minimalist, performance-optimized WordPress theme dedicated to clarity, design, and intentional living.

Purelyst is an open-source, modern WordPress theme designed for bloggers, writers, and content creators who value simplicity, readability, and blazing-fast performance. Built with Core Web Vitals in mind, it delivers an exceptional user experience while maintaining a beautiful, contemporary aesthetic.

• 🎨 Clean, Minimalist Design - Focus on content with elegant typography and generous whitespace
• 📱 Fully Responsive - Optimized layouts for desktop, tablet, and mobile devices
• 🌙 Dark Mode Support - Automatic dark mode based on system preferences
• 🖼️ Hero Section - Stunning featured post showcase on homepage
• 📰 CSS Grid Layout - Modern grid-based article cards

• ⚡ Core Web Vitals Optimized - Excellent LCP, FCP, CLS, and TBT scores
• 🚀 Critical CSS Inlining - Above-the-fold styles render instantly
• 🔄 Lazy Loading - Images load on-demand for faster initial page load
• 📦 Minimal Dependencies - No bloated frameworks or libraries
• 🗜️ Optimized Assets - Deferred scripts and async stylesheets

• 🎛️ Admin Settings Panel - Comprehensive theme options with live preview
• 🎨 WordPress Customizer - Easy visual customization
• 🔤 Typography Options - Choose from multiple font families and weights
• 🌈 Color Customization - Primary, accent, and background color controls
• 📝 Read More Button - Customizable button text and colors

• ♿ Accessibility Ready - WCAG compliant with proper ARIA labels and skip links
• 🌍 Translation Ready - Full internationalization (i18n) support
• 🔍 SEO Optimized - Clean, semantic HTML structure
• 📋 Well Documented - Clear code comments and documentation
• 🧩 Hooks & Filters - Extensible via WordPress actions and filters

Tested on Google PageSpeed Insights (Mobile - Slow 4G throttling):

• Preconnect hints for Google Fonts
• Critical font preloading
• Deferred JavaScript loading
• Conditional block library CSS removal
• Responsive images with srcset
• Explicit image dimensions for CLS prevention
• fetchpriority="high" for LCP images

1. Download the theme zip file from GitHub Releases
2. Go to WordPress Admin → Appearance → Themes
3. Click "Add New" → "Upload Theme"
4. Choose the downloaded zip file and click "Install Now"
5. Activate the theme

cd wp-content/themes/
git clone https://github.com/numanrki/Purelyst.git

Navigate to Appearance → Purelyst to access:

Navigate to Appearance → Customize to configure:

• Hero Section - Featured post selection and badge text
• Sidebar Settings - Author widget configuration
• Newsletter Widget - Email signup form
• Header Settings - Search toggle, Subscribe button
• Social Links - Social media profile URLs

purelyst/
├── 📁 assets/
│   ├── 📁 css/
│   │   ├── admin-style.css      # Admin panel styles
│   │   └── editor-style.css     # Block editor styles
│   ├── 📁 images/
│   │   └── placeholder.svg      # Placeholder image
│   └── 📁 js/
│       ├── admin.js             # Admin panel scripts
│       ├── customizer.js        # Live preview scripts
│       └── main.js              # Frontend scripts
├── 📁 inc/
│   ├── admin-settings.php       # Admin settings panel
│   ├── customizer.php           # Customizer options
│   └── template-tags.php        # Template helper functions
├── 📁 template-parts/
│   ├── content-card.php         # Article card template
│   └── content-none.php         # No content template
├── 404.php                      # 404 error page
├── archive.php                  # Archive template
├── comments.php                 # Comments template
├── footer.php                   # Footer template
├── front-page.php               # Homepage template
├── functions.php                # Theme functions
├── header.php                   # Header template
├── index.php                    # Main template
├── page.php                     # Page template
├── search.php                   # Search results
├── searchform.php               # Search form
├── sidebar.php                  # Sidebar template
├── sidebar-single.php           # Single post sidebar
├── single.php                   # Single post template
├── style.css                    # Main stylesheet
└── theme.json                   # Block editor config

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• ⚡ Performance optimizations for Core Web Vitals
• 🔧 Critical CSS inlining
• 🖼️ LCP image preloading
• 📦 Conditional block library CSS removal
• 🔄 Deferred JavaScript loading
• 🎨 Author box moved to post content
• ✨ Admin settings panel improvements

• 🎉 Initial release

Numan Rasheed

• WordPress.org: @numanrki
• GitHub: @numanrki
• Twitter: @numanrki

This project is licensed under the GNU General Public License v2 or later.

See LICENSE for more information.

Made with ❤️ for the WordPress community

⭐ Star this repository if you find it helpful!

• Initial release