# More guides

> Contributor-facing guides that live in the repository and open on GitHub.

These contributor-facing guides live in the repository's `docs/guides/` directory and open on GitHub. They cover operational and tooling topics for people working on Tidings itself, so most self-hosters won't need them.

- [Environment management](https://github.com/tvhahn/tidings/blob/main/docs/guides/environment-management.md) — uv setup, Python environment, and dependency management.
- [Dev surfaces](https://github.com/tvhahn/tidings/blob/main/docs/guides/dev-surfaces.md) — The frontend port map: the five dev surfaces, port-override flags, and BrowserRouter basename rules.
- [DevContainer startup](https://github.com/tvhahn/tidings/blob/main/docs/guides/devcontainer-startup.md) — DevContainer lifecycle and environment priming.
- [Slash commands](https://github.com/tvhahn/tidings/blob/main/docs/guides/slash-commands.md) — Category management, test review, spending insights, and doc review slash commands.
- [Static-hosted demo](https://github.com/tvhahn/tidings/blob/main/docs/guides/static-hosted-demo.md) — Building, previewing, and regenerating fixtures for the static Cloudflare Pages demo.
- [DynamoDB cost analysis](https://github.com/tvhahn/tidings/blob/main/docs/guides/dynamodb-cost-analysis.md) — The DynamoDB cost model and sizing assumptions.
- [Releases](https://github.com/tvhahn/tidings/blob/main/docs/guides/releases.md) — Versioning policy, branching model, and the step-by-step release ritual.