# 🏛️ Empire Tools — Template Theme

A dark, mobile-first WooCommerce storefront theme built to be **re-skinned
and re-used**. Out of the box it renders the Empire Tools look exactly; every
color and major chrome piece is a setting, and every store feature lives in
the companion [Empire plugin suite](../../plugins/README-EMPIRE-SUITE.md) so
the theme stays purely presentational.

## Change the color palette

**Appearance → Customize → Empire Theme — Palette.** Thirty-five tokens
cover the whole design: page background, surfaces, cards, borders,
body/muted/secondary/form text, panels (payment box, checkout blocks, form
fields), accent + pressed accent + hero-gradient ends, gold pair, deal
green, alert red, cream, and the image scrim. They map 1-to-1 onto the CSS
variables declared at the top of `style.css` — the Customizer emits
overrides only for tokens you actually change (plus the matching rgb
triplets for translucent tints), so an untouched install ships zero extra
CSS. `--et-deal` colors every price, saving, and countdown; `--et-accent`
colors every button and badge.

**Light themes work.** Set a light page background and the theme flips
`color-scheme` to light automatically; the Factorize Site Builder ships three
ready light palettes (linen / cloud / blush) alongside the five dark ones,
each setting all 35 tokens — including the status colors (savings, returns, required, alerts) and the mobile bottom bar, so nothing dark-only leaks onto a light page.

## Toggle features on and off

**Appearance → Customize → Empire Theme — Features:** mobile bottom tab
bar, desktop nav row, header account icon, drawer account link, footer
menu. Store *behavior* toggles live with their features — each Empire
plugin can be deactivated independently on the Plugins screen, and each has
its own `config.php` knobs (see each plugin's README).

## Extend it

Templates fire three theme hooks for plugins and child themes:

| Hook | Fires |
|---|---|
| `empire_header_end` | inside `</header>`, after search + nav |
| `empire_drawer_end` | at the end of the slide-out drawer |
| `empire_footer_start` | just before the footer |

The suite plugins attach everything else through standard WooCommerce
hooks, so a child theme can restyle freely without touching behavior.
Design tokens live at the top of `style.css`; templates are plain WordPress
(`header.php`, `footer.php`, WooCommerce overrides in `woocommerce/`).

## Re-using it for another store

1. Copy the theme + whichever suite plugins the store needs.
2. Set the palette in the Customizer; upload a logo (Site Identity).
3. Toggle off chrome you don't want; deactivate plugins you don't need.
4. Content (pages, hero, storefront photos) comes from the Elementor
   templates / seeds in this repo — replace images and copy per store.
