Skip to content

What it is

cityvote.com: civic news by topic (city council, elections and ballots, budget and taxes, housing and zoning, transit and streets, schools). The Astro build in apps/cityvote/web is served by the axum in apps/cityvote/server on port 4321, with no credential in the image.

Stories

A story is a markdown file in apps/cityvote/web/src/content/stories. Its frontmatter names its topics, byline, date and sources, and how it was made: person (written by a person) or ai-reviewed (drafted with AI, reviewed by a person). The page prints that label on the story, so a reader always knows. A story marked sample: true builds in development only and never ships.

Following topics needs sign-in, which comes after this first release.

Releasing

StepWhat happens
Bump version: aboveThe only edit a release needs
cityvote-web jobStamps version.toml and the crate manifest, builds, pushes $IMAGE:$VERSION
cityvote-web-deploy jobOpens a merge request repointing cityvote-deployment.yaml
ArgoCDSyncs the default branch

Discuss on the forum

Questions, fixes and notes on this page live in the KBVE forum.