# lora.vegas

Las Vegas Meshtastic and LoRa community website.

## About

This site provides information about the Las Vegas mesh networking community,
including:

- Mesh channel configurations
- Community coordination (Discord, Signal)
- Meetup information
- Local resources

## Contributing

To contribute to this site, contact **sneak@sneak.berlin** for git repository
access.

## Technical Details

This is a static site built with Hugo. The site is deployed automatically via
GitHub Actions.

### Local Development

```bash
hugo server
```

Visit http://localhost:1313 to preview.

### Build

```bash
hugo
```

Output will be in the `public/` directory.

## Entrypoints

This repository adheres to the
[Scripts to Rule Them All](https://github.com/github/scripts-to-rule-them-all)
standard: normalized scripts in `script/` are the entrypoints for the
development workflow, and the Makefile targets are thin shims that call them. We
provide:

- `script/bootstrap` — install all build dependencies (git, make, go, hugo,
  node/npm) idempotently. Hugo is pinned to an exact version and installed with
  `go install`, which verifies it against `sum.golang.org`; the version is the
  `HUGO_VERSION` constant at the top of the script
- `script/setup` — prepare a fresh clone: run `script/bootstrap` and install the
  git pre-commit hook
- `script/test` — the correctness check: a clean `hugo --minify` production
  build
- `script/lint` — a clean build that surfaces broken links and path collisions
- `script/fmt` — format the repo's own top-level markdown docs with prettier
- `script/fmt-check` — check that formatting (read-only)
- `script/check` — run `script/test`, `script/lint`, then `script/fmt-check`;
  modifies no tracked files
- `script/docker` — build the Docker image tagged with the project name
- `script/cibuild` — the CI build; the Dockerfile runs `make check`
- `script/install-precommit` — install the git pre-commit hook that runs
  `script/check`

Build the image through `script/cibuild` or `script/docker` only. Both pass a
per-invocation `CHECK_EPOCH` build argument that the Dockerfile requires, so the
`make check` layer can never be served from cache — without it Docker returns a
green it did not earn. A bare `docker build .` fails closed on the Dockerfile's
`CHECK_EPOCH` guard rather than caching its way to a false success.

A convenience `make serve` target runs `hugo server` for local preview.

## License

Content is provided as-is for community use.