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.
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.
- Node.js (v24.0.0 or newer)
- A HubSpot CMS development account for uploads.
jqfor the Git hooks and post-fetch cleanup (brew install jqon macOS).- The HubSpot CLI is installed locally with the project's dependencies. A global installation is not required.
- Clone the repo and
cdinto it. - Run
nvm useif you use nvm, thennpm ci. Installation also sets up the Husky hooks. - Run
npx --no-install hs account authto authenticate, thennpx --no-install hs account useto select your development account. - Run
npm startto 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. - Run
npm run buildfor a local build and a theme zip in_dist/. - Run
npm run upload:hubspotto rebuild CSS and JavaScript and uploadtheme/to/FreshJuiceDEV.
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.
- Tailwind CSS – Utility-first CSS framework.
- Alpine.js – Minimal JavaScript framework for declarative interactivity.
- HubSpot CMS CLI – Local development toolkit for HubSpot.
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
If you find an issue, open an issue. Contributions are welcome — fork the repo and submit a pull request.
We use SemVer for versioning. See the releases page for available versions.
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.