# Larder

A warm WordPress block theme built for food shops, farm stores, and organic markets. Works with WooCommerce and the Site Editor out of the box.

![Larder theme preview](.github/preview/larder-preview.gif)

## Screenshots

| Homepage | Shop |
|---|---|
| ![Homepage](.github/preview/home.png) | ![Shop](.github/preview/shop.png) |

| Single product | Blog archive |
|---|---|
| ![Single product](.github/preview/single-product.png) | ![Blog archive](.github/preview/blog.png) |

| Featured products | Footer |
|---|---|
| ![Featured products](.github/preview/featured-product.png) | ![Footer](.github/preview/footer.png) |

## What it does

Larder ships a ready-to-go front page with a hero banner, product categories, featured products, sale items, and new arrivals. Everything is editable through the Site Editor. Pick your colors, swap fonts, rearrange sections, all without code.

The theme plays well with WooCommerce. Product grids, cart, checkout, and mini cart work out of the box. If you don't need a shop, it works fine as a blog or content site too.

Two style variations are included (Earth tones and Forest green) for quick redesigns.

## Features

- Full Site Editing with customizable templates, parts, and patterns.
- WooCommerce support: Product Collection, Cart, Checkout, Mini Cart.
- Lora and Source Sans 3 fonts, self-hosted for GDPR compliance and faster loads.
- Warm color palette that fits food, grocery, and organic store branding.
- Two style variations.
- Homepage patterns: hero, categories, featured products, on sale, new arrivals, call to action.
- Mobile-friendly with a clean slide-in menu and full-screen search overlay.
- Accessible: visible focus states, screen reader text, reduced motion support.

## Requirements

- WordPress 6.7 or later.
- PHP 8.0 or later.
- WooCommerce (optional, for shop features).

## Installation

1. Download the latest release zip from [Releases](https://github.com/shameemreza/larder/releases) or from [WordPress.org](https://wordpress.org/themes/larder/).
2. Upload the zip through Appearance > Themes > Add New > Upload Theme.
3. Activate the theme.
4. Open the Site Editor to customize templates, colors, fonts, and patterns.

## Development

Clone the repo into your local WordPress themes directory:

```bash
cd wp-content/themes
git clone git@github.com:shameemreza/larder.git
```

No build step required. The theme uses vanilla CSS and JavaScript.

## License

GPLv2 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-2.0.html) for details.

Fonts are licensed under [SIL Open Font License 1.1](https://scripts.sil.org/OFL). The hero image is AI-generated by the theme author and licensed GPLv2.
