Skip to content

A starting point for creating a unique HubSpot CMS theme with TailwindCSS, AlpineJS, and additional features.

License

Notifications You must be signed in to change notification settings

freshjuice-dev/freshjuice-hubspot-theme

Repository files navigation

🍹 FreshJuice DEV – Developer Edition of the FreshJuice HubSpot Theme

GitHub Release GitHub last commit GitHub License GitHub watchers GitHub forks GitHub Repo stars

FreshJuice DEV is a modern, clean, and minimalistic HubSpot CMS theme designed specifically for developers. Built with Tailwind CSS and Alpine.js, it offers full flexibility and a clean architecture, making it easy to customize and extend for real-world production use.

Demo website →


Purpose

This theme helps developers get a head start on HubSpot CMS theme development. While most HubSpot themes are heavy and bloated, FreshJuice DEV is intentionally minimal — it loads only the components you actually need, resulting in a pixel-perfect design and a fast-loading website.


Getting Started

Prerequisites

Installation

  1. Clone the repo and cd into it.
  2. Run npm install (requires Node v22.0.0+).
  3. Run npm run prepare to install Husky hooks.
  4. For local development: npm run start — runs Tailwind CSS, esbuild, and HubSpot CLI with file watching, rebuild, and live upload to HubSpot.
  5. For production build: npm run build — builds Tailwind CSS and JavaScript.
  6. For uploading to HubSpot: npm run upload:hubspot — uploads the theme via HubSpot CLI.

Tech Stack

  • Tailwind CSS – Utility-first CSS framework.
  • Alpine.js – Minimal JavaScript framework for declarative interactivity.
  • HubSpot CMS CLI – Local development toolkit for HubSpot.

Project Structure

source/                   # Theme source files
├── css/                  # Source CSS files (Tailwind CSS)
├── images/               # Source images and assets
└── js/                   # Source JavaScript files

theme/                    # Compiled theme files for HubSpot
├── css/                  # Compiled CSS files
├── images/               # Images and icons
├── js/                   # Compiled JS and vendor scripts
├── macros/               # HubL macros
├── modules/              # HubL modules
├── sections/             # HubL sections
└── templates/            # HubL templates
    ├── layouts/          # Layout templates
    ├── partials/         # Partial templates
    └── system/           # System templates

Contributing

If you find an issue, open an issue. Contributions are welcome — fork the repo and submit a pull request.


Versioning

We use SemVer for versioning. See the releases page for available versions.


License

Distributed under the MIT License. See the LICENSE file for the full text.

Key points of the MIT License:

  • You can use, copy, and modify the software.
  • You can distribute original or modified versions of the software.
  • You can include the software in commercial products or services.
  • You must include the same license text in all copies or substantial portions of the software.
  • No warranty is provided and no patent rights are granted.

About

A starting point for creating a unique HubSpot CMS theme with TailwindCSS, AlpineJS, and additional features.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 2

  •  
  •