2025.pybeach.org

This is the source for 2025.pybeach.org.

The site is built using corvid and the project is managed by uv. modd and devd are highly useful for local development, but not required.

Setup and Development

1. Install uv to get started.
2. Run uv sync to set up the project locally
3. Install modd if you’d like.
4. Install devd if you’d like.

Once that’s all done, the following commands are useful:

• If you installed modd and devd, run uv run modd to start the build + serve daemon. You should be able to see a continuously updated local version of the site at http://localhost:8000/.
• If you don’t want to use modd and devd, you can run uv run corvid to build the site, and then see the results in the output/ directory.
• You can add new dependencies via uv add.

Files

Files in the input/ directory power the content of the site. corvid converts every Markdown file (.md) into an HTML file (.html), so input/helloworld/index.md becomes output/helloworld/index.html, which in turn makes it visible at https://2025.pybeach.org/helloworld. All other files are simply copied over.

The main template is in the templates/ directory, should you need to edit that.

Infrastructure

The site is deployed in @nkantar’s Render account from the main branch. PR previews are also generated so you can verify your changes somewhere more real than your local machine. The domain is registered by @nkantar through Porkbun. SSL is provided by Let’s Encrypt.