Start with something real.
Install Caramel 0.7.0, create a bookshelf, and check the generated feature with real application tests.
The source installation targets Apple Silicon macOS. Install Apple Command Line Tools first; development dependencies use its C compiler and archiver. Caramel supplies its own pinned Crystal 1.21.1, PostgreSQL, Caddy, and CoreDNS.
01 · Install the release
Start from the release tag so new applications depend on the published Caramel shard. Add ~/.local/bin to your shell’s PATH if it is not already there.
git clone --branch v0.7.0 https://github.com/caramelizedev/caramel.git caramel
cd caramel
scripts/install-toolchain
scripts/build-release
bin/frappe installations register
frappe services startConfigure the local resolver and ports once per machine. The apply step installs system integration and asks for administrator privileges; latte trust install trusts Latte’s local certificate authority in your login keychain.
scripts/install-local-integration prepare /private/tmp/caramel-integration-bundle
sudo scripts/install-local-integration apply /private/tmp/caramel-integration-bundle
latte trust installThe current release guide lists the supported APIs and development requirements.
Read the current release guide →02 · Create your bookshelf
frappe new bookshelf
cd bookshelf
frappe make resource Book title:string author:string
frappe migrate
frappe devfrappe new installs dependencies, configures the local site, and applies the starter migrations. The resource generator adds application-owned models, changesets, actions, Blueprint views, and request specs.
03 · Check your first feature
frappe routes books
frappe check
frappe corretto
frappe lintExpect book routes, a successful type check, and passing generated request specs. Corretto uses isolated test databases; your development records remain separate. Run these checks in your application; this learning path is not yet validated as a complete recipe.