# 🎨 Elemental Starter Theme

**A modern, beautiful WordPress theme built on Bulma CSS Framework**

## ✨ Features

- ✅ **Bulma CSS Framework** - Modern, responsive grid system
- ✅ **Custom Post Types** - Team Members & Testimonials
- ✅ **WordPress Dashicons** - Built-in icons, always work
- ✅ **WooCommerce Ready** - Full e-commerce support
- ✅ **Responsive Design** - Looks great on all devices
- ✅ **Clean Code** - WordPress coding standards compliant
- ✅ **Modern Typography** - Beautiful sans-serif font stack
- ✅ **Classy Animations** - Smooth transitions and effects
- ✅ **Light/Dark Mode** - Theme switcher (coming soon)
- ✅ **Zero Dependencies** - No Font Awesome CDN needed

## 🚀 Quick Start

1. **Upload** the theme folder to `wp-content/themes/`
2. **Activate** in WordPress admin: Appearance → Themes
3. **Customize** via Appearance → Customize (basic options)
4. **Optional:** Install Kirki plugin for advanced customization

## 📋 Template Hierarchy

- `front-page.php` - Static homepage with hero, blog, team, testimonials
- `home.php` - Blog posts page (same as front-page)
- `index.php` - Ultimate fallback template
- `single.php` - Single post display
- `page.php` - Page display
- `archive.php` - Archive listings with sidebar
- `search.php` - Search results
- `404.php` - Error page

## 🎯 Custom Post Types

### Team Members (`team`)
**Meta Fields:**
- Position/Title
- Email
- Phone
- Social Links (Facebook, Twitter, LinkedIn)

**Usage:** Create team member profiles with photos, bios, and contact info

### Testimonials (`testimonial`)
**Meta Fields:**
- Client Name
- Client Company
- Rating (1-5 stars)

**Usage:** Display client reviews and feedback

## 🎨 Customization

### Basic (Built-in WordPress Customizer)
- Logo upload
- Site title & tagline
- Menus
- Widgets

### Advanced (Requires Kirki Plugin - Optional)
Install Kirki for 100+ advanced options:
- Colors & branding
- Typography (900+ Google Fonts)
- Layout options
- Header/Footer customization
- Blog settings
- WooCommerce styling
- Custom code insertion

## 📦 What's Included

```
elemental-starter/
├─ style.css (Theme header)
├─ functions.php (Main functions)
├─ header.php (Site header)
├─ footer.php (Site footer)
├─ index.php (Fallback)
├─ front-page.php (Homepage)
├─ home.php (Blog page)
├─ single.php (Single post)
├─ page.php (Pages)
├─ archive.php (Archives)
├─ search.php (Search)
├─ 404.php (Error page)
├─ sidebar.php (Sidebar)
├─ searchform.php (Search form)
├─ comments.php (Comments)
├─ assets/
│  ├─ css/
│  │  └─ main.css (All custom styles)
│  └─ js/
│     ├─ main.js (Theme JS)
│     └─ light-dark-mode.js (Theme switcher)
├─ inc/
│  ├─ custom-post-types.php (Team & Testimonials)
│  ├─ template-tags.php (Template functions)
│  └─ template-functions.php (Helper functions)
└─ template-parts/
   ├─ content.php (Post display)
   └─ content-search.php (Search results)
```

## 🛠️ Technical Details

- **WordPress:** 6.0+
- **PHP:** 7.4+
- **CSS Framework:** Bulma 0.9.4
- **Icons:** WordPress Dashicons (built-in)
- **License:** GPL v2 or later

## 🎯 Built With

- ✅ WordPress Coding Standards
- ✅ Modern PHP practices
- ✅ Semantic HTML5
- ✅ Accessible (WCAG compliant)
- ✅ SEO optimized
- ✅ Translation ready

## 💡 Credits

**Built by:** CursorWP  
**Framework:** Bulma CSS  
**Icons:** WordPress Dashicons  
**License:** GPL v2+  
**Type:** Free & Open Source (Donationware)

## 🎉 Support

This theme is **Donationware** - free as in free beer for the global WordPress community!

If you find it useful, consider supporting: [PayPal Donation](https://www.paypal.com/donate?hosted_button_id=YZ4447HJ7JHZU)

## 📝 Changelog

### Version 1.0.0
- Initial release
- Bulma CSS Framework integration
- Custom Post Types (Team & Testimonials)
- Dashicons implementation
- Full WooCommerce support
- Responsive design
- Modern typography
- Classy animations

---

**Made with ❤️ by CursorWP | Vibe Coded with Cursor AI** 🎯✨