Pamplejuce is a template lifestyle for creating and building JUCE plugins in 2026.

Out-of-the-box, it:

1. Runs C++23
2. Uses JUCE 9.x as a git submodule (tracking develop).
3. Uses CPM for dependency management.
4. Relies on CMake 3.25 and higher for cross-platform building.
5. Has Catch2 v3.8.1 for the test framework and runner.
6. Includes a Tests target and a Benchmarks target with examples to get started quickly.
7. Has Melatonin Inspector installed as a JUCE module to help relieve headaches when building plugin UI.

It also has integration with GitHub Actions, specifically:

1. Building and testing cross-platform (linux, macOS, Windows) binaries
2. Running tests and benchmarks in CI
3. Running pluginval 1.x against the binaries for plugin validation
4. Config for installing Intel IPP
5. Code signing and notarization on macOS
6. Windows code signing via Azure Trusted Signing

It also contains:

1. A .gitignore for all platforms.
2. A .clang-format file for keeping code tidy.
3. A VERSION file that will propagate through JUCE and your app.
4. A ton of useful comments and options around the CMake config.

How does this all work at a high level?

Check out the official Pamplejuce documentation.

Setting up for YOUR project

This is a template repo!

That means you can click "Use this template" here or at the top of the page to get your own copy (not fork) of the repo. Then you can make it private or keep it public, up to you.

Then check out the documentation so you know what to tweak.

Using an AI coding agent? The included CLAUDE.md / AGENTS.md has a first-time setup wizard — just ask your agent to set up the project and it will walk you through naming, CI configuration, and code signing.

[!NOTE] Tests will immediately run and fail (go red) until you set up code signing.

Having Issues?

Thanks to everyone who has contributed to the repository.

This repository covers a lot of ground. JUCE itself has a lot of surface area. It's a group effort to maintain the garden and keep things nice!

If something isn't just working out of the box — it's probably not just you — others are running into the problem, too, I promise. Check out the official docs, then please do open an issue!