Guides

Every guide is a worked project: the commands, their real output, and what it means. Start at the top; branch when a project calls you.

Build

• Your first site

  Install the binary, cherry new, write a post, put it on the internet. Fifteen minutes, no Elixir required to run it.

• Pages and the landing page

  Static pages from plain markdown files, and a landing page with a hero: raw HTML, theme classes, and custom.css.

• Build a portfolio and host your CV

  The developer timeline, story pages that cross-link your work by tag, and a print-ready CV with JSON Resume output.

• Create a theme

  Scaffold from an official theme, retune its tokens, restyle it, and rewrite a template in HEEx with function components.

Write and verify

• The authoring loop

  gen.post, edit, serve, publish, and the markdown mirrors every route ships.

• The verifier

  cherry check builds in memory and hands back structured diagnostics: the build, check, fix loop that keeps a site honest.

• Restyle without forking

  Token overrides from one command, custom.css that always wins, ejects with provenance, and theme.diff so your look survives upgrades.

Ship and run

• Deploying to GitHub Pages

  gen.action writes the workflow; Pages setup, custom domains, and project-page base paths.

• Deploying to Cloudflare

  gen.action --host cloudflare writes wrangler.jsonc and the workflow; Workers static assets, _headers and _redirects, custom domains.

• Scripting and agents

  The --json envelope contract, schemas, llms.txt, and markdown mirrors, from jq one-liners to the shipped agent skill.

• Using Cherry from Elixir

  The hex package behind the binary: cherry_new scaffolding, mix task parity, and the library API for custom tooling.

• Staying current

  cherry upgrade swaps the binary in place, checksum-verified against the release.

Looking for reference rather than a walkthrough? The docs cover every verb, config key, and schema.