blaze-theme Svelte Themes

Blaze Theme

theme for wordpress using tailwind css and svelte

πŸ”₯ Blaze Theme

Modern, blazing-fast WordPress theme built with Tailwind CSS v4 and Svelte components.


πŸ“– Table of Contents


🎯 Overview

Blaze Theme adalah tema WordPress modern yang menggabungkan kekuatan Tailwind CSS v4 untuk styling yang fleksibel dan Svelte untuk komponen interaktif yang reaktif. Tema ini dirancang untuk memberikan performa maksimal dengan developer experience yang luar biasa.

Why Blaze?

  • ⚑ Blazing Fast - Optimized build dengan Vite dan code splitting
  • 🎨 Modern Design - Clean, minimalist, dan fully customizable
  • πŸ“± Fully Responsive - Mobile-first approach
  • β™Ώ Accessible - WCAG 2.1 compliant
  • πŸ”§ Developer Friendly - Clean code, well documented
  • 🎭 Component-Based - Reusable Svelte components
  • 🎨 Utility-First CSS - Tailwind CSS v4 power
  • πŸ› οΈ Easy Customization - WordPress Customizer integration

✨ Features

Core Features

  • βœ… WordPress 6.7+ compatible
  • βœ… Full Site Editing (FSE) ready
  • βœ… Gutenberg block support
  • βœ… WooCommerce compatible
  • βœ… SEO optimized
  • βœ… Translation ready (WPML & Polylang)
  • βœ… RTL (Right-to-Left) support
  • βœ… Child theme ready

Design Features

  • 🎨 Dark mode support
  • 🎨 Multiple blog layouts (Grid, Masonry, List)
  • 🎨 Custom color schemes
  • 🎨 Typography options
  • 🎨 Flexible header & footer
  • 🎨 Mega menu support

Components

  • 🧩 Interactive header with search
  • 🧩 Mobile-friendly navigation
  • 🧩 Newsletter subscription
  • 🧩 Post cards with hover effects
  • 🧩 Modal dialogs
  • 🧩 Loading states
  • 🧩 Customizer controls (Color picker, Range slider)

Performance

  • ⚑ Lazy loading images
  • ⚑ Optimized asset loading
  • ⚑ Minimal JavaScript footprint
  • ⚑ Critical CSS inlining
  • ⚑ Browser caching support
  • ⚑ CDN ready

πŸ“‹ Requirements

  • WordPress: 6.0 or higher
  • PHP: 7.4 or higher (8.0+ recommended)
  • Node.js: 18.0 or higher
  • NPM: 9.0 or higher

Optional

  • WooCommerce: 8.0+ (for e-commerce features)
  • Composer: 2.0+ (for dependency management)

πŸš€ Installation

Quick Install (Production)

  1. Download the theme

    # Clone or download from repository
    git clone https://github.com/yourusername/blaze-theme.git
    
  2. Upload to WordPress

    • Go to wp-content/themes/
    • Upload the blaze-theme folder
    • Or use WordPress admin: Appearance β†’ Themes β†’ Add New β†’ Upload Theme
  3. Activate the theme

    • Go to Appearance β†’ Themes
    • Click Activate on Blaze Theme
  4. Install dependencies and build

    cd wp-content/themes/blaze-theme
    npm install
    npm run build
    

Developer Install

  1. Clone the repository

    cd wp-content/themes/
    git clone https://github.com/yourusername/blaze-theme.git
    cd blaze-theme
    
  2. Install dependencies

    npm install
    
  3. Start development server

    npm run dev
    
  4. Activate theme in WordPress admin


πŸ› οΈ Development

Available Scripts

# Development mode with hot reload
npm run dev

# Build for production
npm run build

# Watch mode (auto rebuild on changes)
npm run watch

# Clean build directory
npm run clean

# Lint JavaScript/Svelte
npm run lint

# Format code with Prettier
npm run format

# Type checking (if using TypeScript)
npm run type-check

Development Workflow

  1. Start dev server

    npm run dev
    
  2. Make your changes in svelte/ or assets/ directories

  3. View changes - Vite will hot reload your changes automatically

  4. Build for production when ready

    npm run build
    

Environment Setup

Create .env file (optional):

# Development
VITE_DEV_SERVER_PORT=5173
VITE_DEV_SERVER_HOST=localhost

# WordPress
WP_HOME=http://localhost/wordpress
WP_SITEURL=http://localhost/wordpress

πŸ“ Theme Structure

blaze-theme/
β”œβ”€β”€ assets/              # Source files
β”‚   β”œβ”€β”€ css/            # Tailwind CSS entry
β”‚   β”œβ”€β”€ js/             # JavaScript files
β”‚   └── images/         # Images and icons
β”‚
β”œβ”€β”€ dist/               # Build output (generated)
β”‚   β”œβ”€β”€ css/           # Compiled CSS
β”‚   └── js/            # Compiled JavaScript
β”‚
β”œβ”€β”€ inc/                # PHP includes
β”‚   β”œβ”€β”€ customizer.php      # Theme customizer
β”‚   β”œβ”€β”€ theme-setup.php     # Theme setup
β”‚   β”œβ”€β”€ enqueue.php         # Asset loading
β”‚   β”œβ”€β”€ template-tags.php   # Helper functions
β”‚   └── admin/              # Admin functionality
β”‚
β”œβ”€β”€ svelte/             # Svelte components
β”‚   β”œβ”€β”€ components/    # UI components
β”‚   β”œβ”€β”€ stores/        # State management
β”‚   └── main.js        # Entry point
β”‚
β”œβ”€β”€ template-parts/     # Reusable template parts
β”‚   β”œβ”€β”€ header/        # Header components
β”‚   β”œβ”€β”€ footer/        # Footer components
β”‚   β”œβ”€β”€ content/       # Content layouts
β”‚   β”œβ”€β”€ post/          # Post components
β”‚   β”œβ”€β”€ page/          # Page components
β”‚   └── blocks/        # Content blocks
β”‚
β”œβ”€β”€ templates/          # Page templates
β”‚   β”œβ”€β”€ full-width.php
β”‚   β”œβ”€β”€ landing-page.php
β”‚   └── blog-grid.php
β”‚
β”œβ”€β”€ languages/          # Translations
β”‚
β”œβ”€β”€ functions.php       # Main functions file
β”œβ”€β”€ style.css          # Theme info (required)
β”œβ”€β”€ index.php          # Main template
β”œβ”€β”€ header.php         # Global header
β”œβ”€β”€ footer.php         # Global footer
└── sidebar.php        # Sidebar template

🎨 Customization

WordPress Customizer

Access via Appearance β†’ Customize

Available Options:

Site Identity

  • Site logo
  • Site title & tagline
  • Site icon (favicon)

Colors

  • Primary color
  • Secondary color
  • Text colors
  • Background colors
  • Link colors

Typography

  • Font family
  • Font sizes
  • Line heights
  • Letter spacing

Layout

  • Container width
  • Sidebar position
  • Blog layout (grid, list, masonry)
  • Posts per page

Header

  • Header style
  • Menu position
  • Search toggle
  • Social icons

Footer

  • Footer layout
  • Widget areas
  • Copyright text
  • Social links

Customizer API (PHP)

// Add custom setting
$wp_customize->add_setting('blaze_custom_setting', [
    'default' => 'value',
    'sanitize_callback' => 'sanitize_text_field',
]);

// Add control
$wp_customize->add_control('blaze_custom_setting', [
    'label' => __('Custom Setting', 'blaze'),
    'section' => 'blaze_section',
    'type' => 'text',
]);

CSS Custom Properties

Theme uses CSS variables for easy customization:

:root {
    --color-primary: #DC2626;
    --color-secondary: #3B82F6;
    --font-family: system-ui, -apple-system, sans-serif;
    --font-size-base: 16px;
    --border-radius: 8px;
    --container-width: 1200px;
}

Override in Additional CSS (Customizer) or child theme.


🧩 Components

Svelte Components

Admin Components

ColorPicker.svelte

<ColorPicker 
    settingId="primary_color"
    defaultColor="#DC2626"
/>

RangeSlider.svelte

<RangeSlider 
    settingId="font_size"
    min={12}
    max={24}
    step={1}
    defaultValue={16}
    unit="px"
/>

Frontend Components

Header.svelte

<Header 
    siteName="Blaze Theme"
    siteTagline="Fast & Modern"
/>

MobileMenu.svelte

<MobileMenu 
    {menuItems}
/>

SearchModal.svelte

<SearchModal 
    searchUrl="/search"
/>

Newsletter.svelte

<Newsletter 
    apiUrl="/wp-json/blaze/v1/newsletter"
/>

Blog Components

PostCard.svelte

<PostCard 
    {post}
/>

PostGrid.svelte

<PostGrid 
    {posts}
    category="all"
/>

PostMeta.svelte

<PostMeta 
    {author}
    {date}
    {category}
    readingTime="5 min"
/>

Shared Components

Button.svelte

<Button 
    variant="primary"
    size="md"
    href="/link"
>
    Click Me
</Button>

Modal.svelte

<Modal 
    title="Modal Title"
    size="md"
>
    <p>Modal content</p>
</Modal>

Loader.svelte

<Loader 
    type="spinner"
    size="md"
    color="primary"
/>

Using Components in PHP

<!-- Mount point for Svelte component -->
<div id="mobile-menu-mount" 
     data-menu-items='<?php echo json_encode($menu_items); ?>'>
</div>

<?php
// Component will auto-initialize via main.js

πŸ“„ Template System

Page Templates

Select template in WordPress editor:

  • Full Width - No sidebar, full content width
  • Landing Page - Hero + sections layout
  • Blog Grid - Posts in grid layout
  • Blog Masonry - Pinterest-style layout
  • No Sidebar - Content without sidebar
  • Blank Canvas - Completely blank page

Template Parts

Reusable template components:

// Load header branding
get_template_part('template-parts/header/site-branding');

// Load post content by type
get_template_part('template-parts/content/content', get_post_type());

// Load post metadata
get_template_part('template-parts/post/post-meta');

// Load custom block
get_template_part('template-parts/blocks/hero');

Custom Template Example

<?php
/**
 * Template Name: Custom Layout
 */

get_header();
?>

<main class="container mx-auto px-4 py-8">
    <?php
    while (have_posts()) :
        the_post();
        get_template_part('template-parts/content/content', 'page');
    endwhile;
    ?>
</main>

<?php
get_footer();

⚑ Performance

Optimization Features

  • Code Splitting - Only load what's needed
  • Tree Shaking - Remove unused code
  • Image Lazy Loading - Native lazy loading
  • Critical CSS - Inline critical styles
  • Asset Minification - Minified CSS/JS in production
  • Caching - Browser cache headers
  • Preloading - Preload critical assets

Performance Tips

  1. Use WebP images for better compression
  2. Enable caching plugin (WP Super Cache, W3 Total Cache)
  3. Use CDN for static assets
  4. Lazy load images (built-in support)
  5. Minimize plugins - Only use what you need
  6. Database optimization - Clean up regularly

Lighthouse Scores

Target scores:

  • Performance: 90+
  • Accessibility: 95+
  • Best Practices: 95+
  • SEO: 100

🌐 Browser Support

Browser Supported Versions
Chrome Last 2 versions
Firefox Last 2 versions
Safari Last 2 versions
Edge Last 2 versions
Opera Last 2 versions
iOS Safari Last 2 versions
Android Chrome Last 2 versions

Note: Internet Explorer is not supported.


🀝 Contributing

We welcome contributions! Here's how you can help:

Reporting Bugs

  1. Check if issue already exists
  2. Create detailed bug report with:
    • WordPress version
    • PHP version
    • Theme version
    • Steps to reproduce
    • Expected vs actual behavior
    • Screenshots (if applicable)

Suggesting Features

  1. Open an issue with [Feature Request] tag
  2. Describe the feature and use case
  3. Provide mockups/examples if possible

Pull Requests

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

Development Guidelines

  • Follow WordPress Coding Standards
  • Use meaningful commit messages
  • Add comments for complex logic
  • Test thoroughly before submitting
  • Update documentation if needed

πŸ“œ License

Blaze Theme is licensed under the GNU General Public License v2 or later.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Full license text: GPL-2.0

Third-Party Licenses

  • Tailwind CSS - MIT License
  • Svelte - MIT License
  • Vite - MIT License
  • Lucide Icons - ISC License

πŸ™ Credits

Created By

Your Name / Team Name

Built With

Special Thanks

  • WordPress community
  • Tailwind Labs team
  • Svelte core team
  • All contributors

πŸ“ž Support

Documentation

Get Help

Professional Support

Need custom development or premium support?


πŸŽ‰ Changelog

Version 1.0.0 (2025-12-29)

  • πŸŽ‰ Initial release
  • ✨ Tailwind CSS v4 integration
  • ✨ Svelte component system
  • ✨ WordPress Customizer integration
  • ✨ Responsive design
  • ✨ Dark mode support
  • ✨ WooCommerce compatibility
  • ✨ Multiple blog layouts
  • ✨ SEO optimized
  • ✨ Translation ready

πŸ—ΊοΈ Roadmap

Version 1.1.0 (Q1 2026)

  • Advanced typography options
  • More blog layouts
  • Header builder
  • Footer builder
  • Animation effects

Version 1.2.0 (Q2 2026)

  • Page builder integration
  • More Gutenberg blocks
  • Advanced WooCommerce features
  • Membership integration
  • Advanced search

Version 2.0.0 (Q3 2026)

  • Full Site Editing (FSE)
  • Block patterns library
  • Theme variations
  • AI-powered features
  • Performance improvements

πŸ“± Follow Us

Stay updated with latest releases and news:


Made with ❀️ and β˜• by [Your Name]

If you find this theme helpful, please consider:

  • ⭐ Starring the repository
  • 🐦 Sharing on social media
  • πŸ’– Buying me a coffee

πŸ”₯ Blaze Theme - Fast. Modern. Beautiful.

Top categories

Loading Svelte Themes