# CraftForge – Agency & Portfolio WordPress Theme

![CraftForge](assets/images/.gitkeep)

**CraftForge** is a premium WordPress theme built for creative agencies, design studios, and freelancers. It features a bold modern design, portfolio showcase with case studies, WooCommerce integration, and full Elementor compatibility.

---

## Features

- **Premium Design** – Dark & gradient-heavy aesthetic with bold typography
- **Portfolio Showcase** – Custom post type with filterable grid, case study layouts, gallery, and testimonials
- **Services** – Dedicated CPT for listing your service offerings
- **WooCommerce Ready** – Fully styled shop pages with custom product cards
- **Elementor Compatible** – 4 custom widgets (Portfolio Grid, Services, Team, Testimonials)
- **Customizer Controls** – Hero section, colors, social links, footer CTA, portfolio/shop settings
- **Block Editor Styled** – Full Gutenberg editor styling via theme.json and editor-style.css
- **Translation Ready** – Complete POT file for localization
- **One Click Demo Import** – Quick setup with sample content
- **Responsive & Accessible** – Mobile-first with ARIA labels and keyboard navigation
- **Performance Optimized** – Minimal dependencies, no jQuery on the frontend

## File Structure

```
craftforge/
├── style.css                      # Theme info + 800+ lines CSS
├── functions.php                  # 400+ lines: CPTs, taxonomies, meta, enqueue
├── theme.json                     # Block editor settings
├── header.php                     # Glass-effect header with mobile menu
├── footer.php                     # CTA, 4-col widgets, social links
├── front-page.php                 # Hero, services, portfolio, stats, testimonials
├── index.php / page.php           # Blog listing, default page
├── single.php                     # Blog post with reading time & share
├── single-portfolio.php           # Case study layout
├── single-service.php             # Service detail with CTA
├── archive.php                    # Blog archive with sidebar
├── archive-portfolio.php          # Portfolio grid with filter
├── archive-service.php            # Services listing
├── search.php / 404.php           # Search results, custom 404
├── sidebar.php / woocommerce.php  # Sidebar, WooCommerce wrapper
├── woocommerce/
│   └── content-product.php        # Custom product card
├── template-parts/
│   ├── content.php                # Blog card
│   ├── content-none.php           # No results
│   ├── content-portfolio-card.php # Portfolio card with hover
│   ├── content-service-card.php   # Service card
│   ├── content-team-card.php      # Team member card
│   └── hero-section.php           # Customizer-driven hero
├── page-templates/
│   ├── template-full-width.php    # Elementor full width
│   ├── template-about.php         # About with team grid
│   ├── template-contact.php       # Contact form + info
│   ├── template-services.php      # All services
│   └── template-portfolio.php     # Full portfolio grid
├── inc/
│   ├── customizer.php             # Customizer sections & controls
│   ├── template-tags.php          # Breadcrumbs, share, reading time
│   ├── demo-import.php            # OCDI configuration
│   ├── elementor-widgets.php      # 4 Elementor widgets
│   ├── portfolio-functions.php    # Portfolio helpers
│   └── woocommerce-hooks.php      # WooCommerce customizations
├── assets/
│   ├── css/
│   │   ├── editor-style.css       # Gutenberg editor styles
│   │   ├── elementor-widgets.css  # Elementor widget styles
│   │   └── woocommerce.css        # WooCommerce overrides
│   ├── js/
│   │   ├── main.js                # Frontend: menu, filter, lightbox
│   │   └── admin.js               # Admin: customizer preview, gallery
│   ├── images/
│   └── fonts/
├── demo-content/
├── languages/
│   └── craftforge.pot             # Translation template
├── docs/
│   ├── installation.md
│   ├── demo-import.md
│   └── customization.md
└── README.md
```

## Requirements

- WordPress 6.0+
- PHP 7.4+

## Installation

See [docs/installation.md](docs/installation.md) for detailed instructions.

## Demo Import

See [docs/demo-import.md](docs/demo-import.md) for one-click demo content setup.

## Customization

See [docs/customization.md](docs/customization.md) for colors, typography, portfolio, WooCommerce, and Elementor setup.

## Credits

- **Fonts:** [Inter](https://fonts.google.com/specimen/Inter), [DM Sans](https://fonts.google.com/specimen/DM+Sans) (Google Fonts, OFL)
- **Icons:** WordPress Dashicons

## License

GNU General Public License v2 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-2.0.html).