Overview

A warm, animated HTML template for coffee roasters, espresso bars and specialty coffee brands. Espressa ships three home pages, a light and a dark theme, right-to-left support, and coffee logic that is worked out rather than typed in: every bag priced by roast, grind and size, a coffee club builder that prices each delivery, a brew-ratio calculator and timer, every bar’s hours with open now, classes with their next dates and seats, and a wholesale estimator.

What’s included

• 3 home pages, each with its own scroll moment: Green To Roasted (a tray of beans darkens through the roast as the band travels), The 25-Second Shot (the dial, the yield and the phases of one espresso) and the Origins Strip (seven origin cards slide sideways)
• Light and dark mode on one switch in every header, remembered between visits and applied before the page paints
• Right-to-left stylesheets and a flag language picker in every header: a right-to-left language turns any page around
• WebGL layers — grind grain at the dark bands’ edges and a roasted bean turning in light in the footer — tinted by the theme colours
• The bean shop: filters by type and roast, a price ceiling, search and sort; the product page prices roast, grind, bag size and quantity
• The coffee club builder in six steps, with a live price per delivery, every four weeks, the saving and the first dates
• The brew guide: seven methods, dose and ratio to water, cup, grind and temperature, and a stage-by-stage timer
• Bar hours with open now, a bar menu with filters and search, classes with seats and booking, origins with a harvest calendar, a wholesale estimator
• Bag, coupon, free-shipping meter, tax, checkout with an order number and roast date, wishlist
• Team and profile, services, gallery, FAQ with search, journal with post formats, account pages, coming soon, 404
• Bean Pile preloader, Diagonal Pour reveals, word-by-word titles, Swiper sliders and Fancybox galleries
• Fully responsive, W3C-valid, zero console errors

Getting Started

Thank you for choosing Espressa. Follow the steps below to get your site live.

1. Open locally

Unzip the downloaded package and open espressa/index.html in any modern browser (Chrome, Firefox, Edge, Safari). No build tools or server are required — the shop, the club builder, the brew timer, the classes and the estimators all work straight from the files.

2. Deploy to a server

Upload the contents of the espressa/ folder to your hosting provider using an FTP client (such as FileZilla) or your hosting control panel. Once uploaded, navigate to your domain and the template will load immediately.

3. Customise

All custom styling lives in assets/css/style.css (with a numbered Table of CSS at the top) and assets/css/responsive.css. Colours and fonts are controlled by CSS variables — see Colors & Fonts. Beans, prices, the club, brew methods, bars, the menu and classes live in one place — see Coffee Logic.

File Structure

Below is an overview of the key files and folders included in this template.

Folder Structure

The package unzips to two folders: Documentation/ (this guide) and espressa/, the template. Every page sits in the template’s root; everything the pages load sits under assets/:

espressa/
├── *.html                              the 31 pages, all in the root (see File Structure)
├── sendmail.php                        the AJAX mail handler for the forms
└── assets/
    ├── css/
    │   ├── style.css                   all custom styles, numbered Table of CSS
    │   ├── style.rtl.css               the right-to-left twin of style.css
    │   ├── responsive.css              breakpoints 1399 / 1199 / 991 / 767 / 575
    │   ├── responsive.rtl.css          the right-to-left twin of responsive.css
    │   ├── fontawesome-all.css         Font Awesome Free, loaded locally
    │   └── plugins/                    vendor stylesheets
    │       ├── bootstrap.min.css
    │       ├── bootstrap.rtl.min.css   Bootstrap for right-to-left pages
    │       ├── jquery.fancybox.min.css
    │       └── swiper-bundle.min.css
    ├── js/
    │   ├── main.js                     all custom scripts, numbered JS INDEX (33 blocks)
    │   └── plugins/                    vendor scripts
    │       ├── bootstrap.bundle.min.js
    │       ├── gsap.min.js
    │       ├── jquery-3.7.1.min.js
    │       ├── jquery.fancybox.min.js
    │       ├── ScrollTrigger.min.js
    │       └── swiper-bundle.min.js
    ├── fonts/
    │   └── theme-icons/                the sun and moon of the theme switch
    ├── webfonts/                       Font Awesome Free font files
    └── img/                            images, one folder per section
        ├── banner/                      13 files
        ├── blog/                        11 files
        ├── flags/                       6 files
        ├── gallery/                     24 files
        ├── home/                        16 files
        ├── icons/                       42 files
        ├── logo/                        4 files
        ├── menu/                        3 files
        ├── ornaments/                   4 files
        ├── shop/                        14 files
        ├── team/                        11 files
        └── textures/                    1 files

To publish the site, upload the contents of espressa/ to your web root. Photos keep their folder, file name and size when you replace them, so no page needs editing.

Colors & Fonts

The whole design is driven by CSS variables declared at the top of style.css. Change a token once and every section, button and card updates. Colours used with transparency have an -rgb twin (for example --es-tan-rgb) — change both together.

Tan fills the buttons, the bean divider under every title and the active states; buttons carry espresso text on tan. Tan Text is tan’s partner for small text on light grounds. Espresso is the ink of the hero washes, the night bands and the footer; cream is the copy on them. White and kraft paper alternate as the section grounds, and the packshot ground sits behind every bag. --es-bg, --es-surface, --es-heading and --es-text are the semantic names the components use — the dark theme swaps those (see Light & Dark Mode).

Fonts

Two Google Fonts are loaded in the head of each page: Marcellus (the caps headings, the menu, prices and figures) and Open Sans (body text, labels and buttons). Swap them by editing the Google Fonts link and the --es-ff-head / --es-ff-body variables.

Logo

The logo is the name ESPRESSA in caps inside a rounded plate, with a roasted bean sitting in a gap of the plate’s top edge. It ships as ready-made PNG files in assets/img/logo/:

• logo.png — espresso ink for light grounds: the kraft headers, the offcanvas, light mode
• logo-light.png — cream ink for dark grounds: the headers over photographs, the footer, dark mode
• seal.png — the round ESPRESSA · COFFEE ROASTERS · EST. 2009 stamp on the heroes and banners
• favicon.png — the browser tab icon

The logo’s lettering appears only inside the images. To use your own logo, replace these files; the header sizes the logo by its height, so a wider or narrower file needs no CSS change.

Light & Dark Mode

Every header (and the mobile menu) has a theme switch. The choice is saved in the browser under the key espressa-theme and applied by a one-line script in the <head> before the page paints, so a dark visitor never sees a light flash. The switch sets data-theme="dark" on the <html> tag.

• Tokens — the dark values sit in one block, [data-theme="dark"] { … }, right after :root in style.css. Change a dark colour there.
• Bands that stay dark — sections with the class is-night (The 25-Second Shot, the hours band, the brew timer, the footer) are dark in both themes. A light card placed inside one takes es-on-light to keep its own ink.
• Illustrated icons and ornaments — each ships in a day and a night ink; the right one shows by theme and ground on its own.
• Start dark — to open the site dark for first-time visitors, add data-theme="dark" to the <html> tag of each page; the switch still works and is still remembered.

Coffee Logic

The figures on every page come from one data block, JS block 09 Roast Data near the top of main.js (var ROAST). Edit it once and the cards, prices, timers, calendars and totals follow. Prices are in US dollars.

Pricing a bag

The coffee club

The brew timer

How the shop totals

Wholesale

The bag, the wishlist and the applied coupon are kept in the browser (localStorage), so they follow the visitor from page to page. The first visit starts with a small demo bag and wishlist so every shop page has something to show; to start empty, set the two demo lists in doShop() (block 24 Bean Shop) to []. Checkout, the club, class bookings and the wholesale enquiry confirm on screen with a reference — connect them to your own systems to take real orders and bookings.

WebGL Layers

Two small WebGL shaders draw the moving layers: the grain — a fine speckle of coffee grounds drifting at the dark bands’ edges (the shot band, the club band, the hours band, the footer, coming soon, 404) — and the bean — a ray-marched roasted bean, its crease cut down the flat face, turning in a warm key light in the footer. Each is one canvas:

<canvas class="es-gl" data-gl="grain" aria-hidden="true"></canvas>

• Colours — each layer reads three colours and an opacity from CSS variables on its canvas or section: --gl-1, --gl-2, --gl-3 and --gl-alpha. The theme switch repaints them.
• Performance — a layer only runs while its section is on screen and the tab is visible. Visitors who prefer reduced motion get one still frame. Without WebGL, the section’s own background shows.
• Remove one — delete the canvas; nothing else depends on it.

RTL (Right To Left)

Espressa is RTL-ready: the layout with its paddings and margins, the side header, the sliders and the animations all mirror. Right to left comes from the stylesheets, not from separate pages: the language picker (a flag and a code) lists the languages that read left to right and right to left. Choosing Arabic stores the language and the direction (keys espressa-lang and espressa-dir) and reloads; the one-line script in <head> then sets dir="rtl" and swaps the three stylesheets for the files named in their data-rtl attribute before the page paints. Nothing is translated — you bring your own right-to-left copy. To make a page right to left for good:

1. Set The Direction

Add dir="rtl" to the page’s <html> tag (and set lang to your language):

<html lang="en" class="no-js" dir="rtl">

2. Swap Three Stylesheets

The scripts read the direction from the dir attribute: sliders, the origins strip and every move that must mirror follow it on their own. The harvest calendar keeps January on the left.

JavaScript Guide

All custom behaviour lives in assets/js/main.js, wrapped in a jQuery IIFE and organised into 33 numbered blocks (see the JS INDEX comment at the top of the file):

• 01–08 — Preloader, Sticky Header, Offcanvas Menu, Scroll Reveals, Back To Top, Anchor Scroll, Light & Dark Mode, Direction, WebGL Layers. The core every page shares: the Bean Pile preloader, the header, the reveals, the theme and direction switch and the WebGL layers.
• 09–10 — Roast Data, Bar Hours. Roast Data holds every figure; Bar Hours works out open now and the next opening of every bar.
• 11–19 — Custom Select, Counters & Rings, Hero Sliders, Card Sliders, Accordion, Filter Tabs, Grid Search, Newsletter, Choice Cards. Shared components: selects, counters, sliders, accordions, filters, search, forms.
• 20–22 — Green To Roasted, The 25-Second Shot, Origins Strip. The three home pages’ scroll moments.
• 23–33 — Contact Form, Bean Shop, Account Forms, Article Tools, Demo Forms, Launch Countdown, Coffee Club Builder, Brew Ratio Timer, Classes & Cuppings, Wholesale Estimator, FAQ Search. The feature pages: contact, the bean shop, accounts, the coffee club builder, the brew timer, classes, the wholesale estimator, FAQ.

Each block is a self-contained doSomething() function that safely skips pages where its section is not present — you can delete any block you do not need. Every animation respects prefers-reduced-motion automatically: content appears in its final state and the scrubbed scenes rest in place.

Images

The download package ships with neutral placeholder images so you can see every layout at the correct dimensions. Replace them with your own photos using the same file names, or update the src attributes. Images are grouped inside assets/img/:

The logo files, the seal, the illustrated icons and ornaments, the kraft paper texture and the language flags are included and ready to use. All demo photography shown on the live preview is for preview purposes only and is not included in the download.

Contact Form

The contact form and the comment form post to sendmail.php, a lightweight AJAX mail handler. The success or error message appears under the button without reloading the page. The newsletter, checkout, coffee club, class booking, wholesale, login, register and forgot-password forms are demo forms: they confirm on screen and are ready to connect to your own systems. To activate the mail handler on your server:

1. Set your email address

Open sendmail.php and replace the placeholder recipient at the top of the file with your own address:

$email = 'example@example.com';

2. Upload to a PHP host

The form needs a server with PHP mail() support (virtually every shared host). It will not send from your local computer or from a static-only host — there the form shows a friendly “upload to a PHP-enabled host” notice instead.

3. Optional: enable Google reCAPTCHA v3

Invisible reCAPTCHA v3 spam protection is already built into the handler. It stays dormant until the form submits a token — that is why no badge or checkbox appears out of the box. To switch it on:

• Create v3 keys (a site key and a secret key) for your domain in the Google reCAPTCHA admin console
• In sendmail.php, replace YOUR_RECAPTCHA_V3_SECRET_KEY with your secret key
• In contact.html, add a hidden token field inside the form and load the reCAPTCHA script with your site key just before </body>:

<!-- inside the form -->
<input type="hidden" name="g-recaptcha-response" id="g-recaptcha-response">

<!-- before the closing </body> tag -->
<script src="https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY"></script>
<script>
  grecaptcha.ready(function () {
    grecaptcha.execute('YOUR_SITE_KEY', { action: 'contact' }).then(function (token) {
      document.getElementById('g-recaptcha-response').value = token;
    });
  });
</script>

Once the token field is present, sendmail.php verifies every submission with Google and rejects low-score (bot) requests.

Credits

This template is built using the following open-source libraries and resources.

• Bootstrap 5.3.3
• jQuery 3.7.1
• Swiper 11
• GSAP 3 + ScrollTrigger
• Fancybox 3.5
• Font Awesome Free
• RTLCSS
• Google Fonts: Marcellus, Open Sans

All plugin files and icon fonts are loaded locally. The only external requests are the Google Fonts stylesheet, the Google Maps embeds and the video popup.

Support

If you have any questions or need help with the template, please reach out through the marketplace where you purchased the template: open the item there and send us your question from its support page. We aim to respond within 24–48 hours.