Overview

A bold, graphic HTML template for craft breweries, taprooms, brewpubs and beer brands. Hopstead ships three home pages, a light and a dark theme, right-to-left support, twelve drawn cans, and brewery logic that is worked out rather than typed in: a beer finder by strength and bitterness, spec sheets with dials, a taproom board that knows when it is open and drops the pint price in the happy hour, a flight builder, tour booking with seats left, a case builder, club pricing, stockists, event dates and a shop with a bag, coupon, shipping and tax.

What’s included

• 3 home pages, each with its own scroll moment: Know Your Pour (ABV and IBU dials sweep with the scroll), The Brewhouse, Step By Step (the brew day slides sideways) and From Lager To Stout (the ground pours from pilsner gold to stout black)
• 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: a right-to-left language turns any page around
• WebGL layers — a grain-textured malt haze in the night bands and a hop cone drawn in light in the footer — tinted by the theme colours
• Beer finder, spec sheets, live tap list, flight builder, table requests, tour booking, case builder, Hop Club pricing, stockists, events with tickets
• The shop: filters, sort and search, product page, bag, coupon, free-shipping meter, tax, checkout with an order number, wishlist
• An age check on the first visit, remembered in the browser
• Pint Fill preloader, Pour Line photo reveals, a pointer spotlight in the taproom band, tilt-follow can tiles
• Fully responsive, W3C-valid, zero console errors

Getting Started

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

1. Open locally

Unzip the downloaded package and open hopstead/index.html in any modern browser (Chrome, Firefox, Edge, Safari). No build tools or server are required — the finder, the taproom board, the booking, the case builder, the club and the shop all work straight from the files.

2. Deploy to a server

Upload the contents of the hopstead/ 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. Beers, hours, tours, cases, club plans, events, brewers, stockists and products live in one place — see Brewery 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 hopstead/, the template. Every page sits in the template’s root; everything the pages load sits under assets/:

hopstead/
├── *.html                              the 30 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 (43 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/                      5 files
        ├── brew/                        15 files
        ├── cans/                        16 files
        ├── cutout/                      1 files
        ├── flags/                       6 files
        ├── icons/                       14 files
        ├── land/                        2 files
        ├── logo/                        4 files
        ├── menu/                        3 files
        ├── pour/                        9 files
        └── team/                        6 files

To publish the site, upload the contents of hopstead/ 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 --hs-mint-rgb) — change both together.

The page is a flat grey ground ruled into cells by hairlines. Mint is the face of the buttons, the chosen tabs and the highlighted cells, always with ink text on it; mint text is its darker partner for small type. Sun and mint fill the starburst stickers; red marks sales; amber is the beer itself (the preloader, the pour line, the colour swatches). Stout is the ground of the night bands and the footer. Each beer brings its own label colour (--tone) and beer colour (--srm) through a tone-<beer> class. --hs-bg, --hs-surface, --hs-heading and --hs-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: DM Sans (headings in a light weight with bold italic accent words, navigation, buttons, figures) and Nunito (body text). Swap them by editing the Google Fonts link and the --hs-ff-head / --hs-ff-body variables. A word wrapped in <em> inside a heading turns bold italic.

Logo

The logo is a hop-cone mascot with one big eye beside the name, “Hop” light and “stead” bold italic. It ships as ready-made PNG files in assets/img/logo/:

• logo.png — for light grounds: the headers, the age check
• logo-light.png — for dark grounds: the preloader, the dark theme, coming soon and 404
• mark.png — the mascot alone
• 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 hopstead-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 taproom band, the brewhouse track, the footer) are stout in both themes; the Hop Club band stays sun yellow.
• 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.

Brewery Logic

The figures on every page come from one data block, JS block 09 Brew Data near the top of main.js (var BREW). Edit it once and the cards, boards, calendars and totals follow. Prices are in US dollars; times are minutes after midnight (a close after 1440 runs past midnight).

Worked examples

How the shop totals

The bag, the wishlist, the applied coupon, a built mixed case and the age check 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 28 Brewery Shop) to []. Checkout, tour booking, tickets, table requests and the club sign-up confirm on screen with a reference — connect them to your own systems to take real orders.

The age check

Block 20 Age Check asks a first-time visitor for legal drinking age and remembers the answer under hopstead-age. Change the wording in the page head, or delete the hs-age dialog from the pages to switch it off.

WebGL Layers

Two small WebGL shaders draw the moving layers: the haze — warm, grain-textured smoke drifting up through the night bands (the taproom band, the brewhouse track, the footer, coming soon, 404) — and the hop — a hop cone drawn in light, its bracts on a spiral, turning slowly in the footer. Each is one canvas:

<canvas class="hs-gl" data-gl="haze" 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)

Hopstead is RTL-ready: the layout with its paddings and margins, 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 hopstead-lang and hopstead-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. The month calendar keeps Sunday on the left, the dials still sweep from empty to full and the brew day still runs from mill to can.

JavaScript Guide

All custom behaviour lives in assets/js/main.js, wrapped in a jQuery IIFE and organised into 43 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 Pint Fill preloader, the header, the Pour Line reveals, the theme and direction switch and the WebGL layers.
• 09–10 — Brew Data, Taproom Clock. Brew Data holds every figure; Taproom Clock works out open now, the happy hour, the kitchen, live pint prices and the next date of each event.
• 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–25 — Age Check, Taproom Spotlight, Tilt Follow, Know Your Pour, The Brewhouse Track, Lager To Stout. The age check, the taproom spotlight, the tilt-follow hover and the three home pages’ scroll moments.
• 26–43 — Brewer Rows, Contact Form, Brewery Shop, Account Forms, Article Tools, Demo Forms, Launch Countdown, Beer Finder, Beer Specs, Flight Builder, Tour Booking, Events Month, Event Tickets, Case Builder, Club Pricing, FAQ Search, Stockist Finder, Table Request. The feature pages: the team list, contact, shop, accounts, the beer finder, spec sheets, the flight builder, tour booking, events, tickets, the case builder, club pricing, FAQ, stockists and table requests.

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 drawn cans and packs, the sticker icons 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, tour booking, ticket, table, club, wholesale, checkout, 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: DM Sans, Nunito
• Can lettering: Google Fonts display faces (inside the images only)

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 popups.

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.