# AskKennyB

This repository contains the source for the Ask KennyB static site. The site source lives under `askkennyb/` and is built with Hugo.

## Deployment Model

Pushes to `main` trigger the Gitea workflow in `.gitea/workflows/deploy.yml`.

That workflow:
- builds the site with `hugo --minify -s askkennyb`
- deploys the generated output in `askkennyb/public/` to Cloudron Surfer

Because CI builds the site on each push, `askkennyb/public/` is local build output and is intentionally ignored in Git.

## Local Development Dependencies

These tools should be available on any development machine used for this project:

- `git`: source control
- `ssh`: access to the Gitea remote at `ssh://git@code.askkb.com:29418/kbondelie/AskKennyB.git`
- `hugo`: required for local builds and previewing the site
- `ripgrep` (`rg`): recommended for fast searching in content and config
- `node` and `npm`: required for the Cloudron Surfer CLI
- `cloudron-surfer` (`surfer`): optional for local deploy testing; CI also uses it

## Version Notes

- Use a recent Hugo version. This repo's vendored `PaperMod` theme declares a minimum Hugo version of `0.146.0`.
- `node` should be reasonably current. The Gitea workflow currently uses Node 18.

## Environment Verification

After setting up a new machine, these commands should work:

```bash
git --version
ssh -V
hugo version
rg --version
node --version
npm --version
surfer --version
```

You can verify the site builds locally with:

```bash
hugo --minify -s askkennyb
```

## Notes

- The `PaperMod` theme is currently vendored in `askkennyb/themes/PaperMod`.
- `.codex` is intentionally left in the repo root as local project context.