Skip to content

About

A developer starter theme for HubSpot CMS with Tailwind CSS, Alpine.js, and extra utilities to accelerate custom theme development.

Topics

Resources

Stars

32 stars

Watchers

2 watching

Forks

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

  • Node.js (v24.0.0 or newer)
  • A HubSpot CMS development account for uploads.
  • jq for the Git hooks and post-fetch cleanup (brew install jq on macOS).
  • The HubSpot CLI is installed locally with the project's dependencies. A global installation is not required.

Installation

  1. Clone the repo and cd into it.
  2. Run nvm use if you use nvm, then npm ci. Installation also sets up the Husky hooks.
  3. Run npx --no-install hs account auth to authenticate, then npx --no-install hs account use to select your development account.
  4. Run npm start to build CSS and JavaScript, upload the whole theme, then watch and upload changes. This writes to your selected HubSpot account; it is not an offline preview.
  5. Run npm run build for a local build and a theme zip in _dist/.
  6. Run npm run upload:hubspot to rebuild CSS and JavaScript and upload theme/ to /FreshJuiceDEV.

HubSpot CLI v8

This is a classic HubL theme, not a HubSpot developer-platform project. Use hs cms commands, not hs project upload. CLI v8 removed the old hs upload, hs watch, and hs fetch commands.

Authentication uses ~/.hscli/config.yml. Follow the CLI's migration prompt if you have an older hubspot.config.yml; keep credentials out of Git. For environment-based authentication, use HUBSPOT_ACCOUNT_ID, not HUBSPOT_PORTAL_ID.

All three npm scripts target /FreshJuiceDEV. Change that path in package.json if your theme has a different Design Tools folder. Select the intended account before uploading or watching. For a one-off upload to another configured account, use npm run upload:hubspot -- --account ACCOUNT_NAME.

npm run fetch:hubspot overwrites local files in theme/ with the remote theme, then removes portal-specific module IDs. Commit or back up local work first. Edit source/css/ and source/js/ for bundled assets; a fetch does not update those sources.

Run npm test to check the CLI scripts offline. It checks command parsing and paths without authenticating or uploading.


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 developer starter theme for HubSpot CMS with Tailwind CSS, Alpine.js, and extra utilities to accelerate custom theme development.

Topics

Resources

Stars

32 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages