lasvegasfortransit.org

The website for Las Vegans for Better Transit, a grassroots advocacy organization fighting for world-class public transit and supportive land use in the Las Vegas Valley.

New contributor? You don't need to know our stack to help. Start at docs/tutorials/start-here.md, and keep the glossary open for any unfamiliar term.

Stack

New to any of these? Each links to its glossary entry.

• Astro — the framework that builds the site into fast static HTML
• MDX content collections (Markdown-plus-components content) with Zod-validated frontmatter, so a typo fails the build instead of shipping
• Tailwind CSS v4 (via @tailwindcss/vite)
• Public Sans (USWDS font, via @fontsource-variable/public-sans)
• Hosted on Cloudflare Pages — fully portable to any static host (Netlify, GitHub Pages, S3+CloudFront).

---

Getting started

To preview the site on your own computer — all most contributors ever need:

pnpm install   # one-time: install dependencies
pnpm dev       # start the local site at http://localhost:4321

That's it: edit a file, see it update live. New to the project or our tools? docs/tutorials/start-here.md walks through this from scratch, and the glossary defines any unfamiliar term.

Full setup (deploying your own copy)

pnpm bootstrap is a single command that takes an empty checkout all the way to a deployed site. It runs seven phases in order — install → auth → workspace → env → repo → deploy → domain — saving progress so an interrupted run resumes cleanly:

pnpm install
pnpm bootstrap   # full interactive setup; add --local-only to skip GitHub/Cloudflare

For what each phase does, the other flags, and how to add a phase, see the bootstrap reference; the first-time-setup tutorial is the hand-held version.

---

Day-to-day commands

Command	Action
pnpm dev	Local dev server at http://localhost:4321
pnpm build	Build production site to ./dist/
pnpm preview	Serve ./dist/ locally
pnpm typecheck	Type-check the Astro app + bootstrap CLI
pnpm lint	Format the codebase with Prettier
pnpm lint:check	Verify formatting (CI mode — exits non-zero on diff)
pnpm test	Visual-regression sweep of every page (see tests/README.md)
pnpm test:update	Refresh visual-regression baselines after intentional UI changes
pnpm test:install	One-time: download the Chromium build Playwright uses
pnpm preflight	Re-check readiness without making changes

Editing content

The full docs live in docs/, organized so you can find things by what you're trying to do (the Diátaxis system). New here? Begin at Start here; for everything else, the docs index lists it all. Common entry points:

• Start here — the new-contributor on-ramp
• Glossary — plain-English definitions of every tool and acronym
• Add an event
• Add a project
• Edit a long-form doc
• Voice and tone — read before drafting
• Content collections reference

Adding an event

Events live in the LVBT Google Calendar, not in this repo. Create the event there; the site rebuilds against the calendar hourly. For events that need long-form copy on their detail page, scaffold an optional MDX body fragment with pnpm event:new. Full reference: docs/explanation/events-pipeline.md.

Project structure

src/
  content/                  # All editable content (MDX + JSON)
    docs/                   # Long-form essays
    pages/                  # Page body copy
    event-bodies/           # Optional long-form body per event (events themselves live in Google Calendar)
    projects/               # Project briefs
    initiatives/            # Project tags (JSON)
  layouts/                  # BaseLayout, DocLayout
  components/               # Reusable UI
  pages/                    # Astro file-based routing
  lib/site.ts               # Single source of truth for org metadata (reads from PUBLIC_LVBT_*)
  styles/global.css         # Tailwind + design tokens
public/                     # Static assets, favicon, robots.txt
scripts/bootstrap/          # The bootstrap CLI (TypeScript via tsx)
tests/                      # Playwright visual-regression harness (see tests/README.md)
src/content.config.ts       # Zod schemas for content collections
astro.config.mjs            # Astro + integrations
playwright.config.ts        # Playwright config (webserver, viewports, snapshot path)
.env.example                # Documents PUBLIC_LVBT_* env vars

Deployment

Pushes to main deploy to production at lasvegasfortransit.org via GitHub Actions; PRs get a Cloudflare Pages preview URL commented on the PR. Full pipeline (build settings, env vars, rollback, manual deploys) is documented in docs/reference/deployment-pipeline.md.

If anything breaks in your environment, run pnpm preflight first — it usually points at the missing piece.

CI/CD

Three workflows in .github/workflows/, all built on three reusable composites in .github/actions/ (setup-node-pnpm, build-site, deploy-cloudflare-pages):

Workflow	Trigger	What it does
ci.yml	Pull requests + non-main pushes	Typecheck → lint:check → check:docs → build (no deploy)
deploy-preview.yml	Same-repo PRs on main	Build + wrangler pages deploy --branch=<head ref> + comment URL
deploy-production.yml	Pushes to main, workflow_dispatch	Build + wrangler pages deploy --branch=main

Required repo secrets (Settings → Secrets and variables → Actions):

Name	Notes
CLOUDFLARE_API_TOKEN	Account-scoped token with Account.Cloudflare Pages:Edit. Create at https://dash.cloudflare.com/<account-id>/api-tokens → "Edit Cloudflare Pages" template. Different token from the bootstrap's DNS token.
CLOUDFLARE_ACCOUNT_ID	Same value the bootstrap persists to .env.local.

Scope CLOUDFLARE_API_TOKEN to the production Environment (Settings → Environments) so non-production jobs can't read it.

License

Site code: MIT. Editorial content (the org's vision, strategy, etc.): all rights reserved by Las Vegans for Better Transit.