About this repo

This is the source of www.audacityteam.org. It uses Astro.

This repo works with npm or Bun.

• Install dependencies: npm install or bun install
• Run dev server: npm run dev or bun run dev
• Build: npm run build or bun run build

Translation

Translations are not yet supported. Please join our dev discord to get notified when they are.

Security

This is a static website, with no user input. As such, regular vulnerabilities likely won't affect us. That said, it probably is good to run npx @astrojs/upgrade (or bunx @astrojs/upgrade) every now and then to update astro to fix security vulnerabilities.

Promos

Promos shown on the site come from two places:

• Campaign promos (MuseHub partners) are the single source of truth on the watched Confluence "Promo Calendar" page. They are generated into src/assets/data/promos/campaigns.ts by the pull command below — never edit that file by hand.
• First-party promos (the Audio.com exit popup, Audacity 4 alpha/video, the survey banner) do not live on Confluence and are maintained by hand in src/assets/data/promos/firstParty.ts.

promotions.ts merges the two; the React/Astro components consume only that merged map.

Pulling campaign promos from Confluence

bun run pull-campaigns              # write campaigns.ts
bun run pull-campaigns --dry-run    # print the module instead of writing

The pipeline:

1. Fetches the watched page's storage HTML.
2. Deterministically extracts the calendar table, preserving destination URLs verbatim (UTM params must never change).
3. Resolves the year-less date ranges and keeps only active and upcoming promos — past rows are dropped (listed under ignoredEntries in the output).
4. Maps each row to a typed PromoData entry using fixed site conventions (banner ⇄ "Top/Promo Banner", video ⇄ "Video embed"; MuseScore-only and "Taken down" rows are skipped).
5. Validates that every emitted URL traces back to the source page.
6. Writes campaigns.ts. It never commits or pushes — review the diff yourself.

Required environment variables (see .env):

• CONFLUENCE_CAMPAIGN_PAGE_URL (or pass --page-url <url>)
• CONFLUENCE_PERSONAL_TOKEN

Optional LLM copy cleanup

The calendar copy is human-authored. Pass --clean-copy to run an LLM pass that may fix typos and shorten copy — it never touches URLs, dates, types, or tracking, and re-runs the URL integrity check afterwards. It is off by default so output stays faithful to Confluence.

bun run pull-campaigns --clean-copy

Backend is auto-selected (the local claude CLI if on PATH, else an OpenAI-compatible API). Override with:

• CAMPAIGN_LLM_BACKEND=claude|api|none
• CAMPAIGN_CLAUDE_COMMAND (default claude)
• CAMPAIGN_LLM_MODEL (or OPENAI_MODEL)
• CAMPAIGN_LLM_API_KEY (or OPENAI_API_KEY)
• CAMPAIGN_LLM_API_URL (default: OpenAI chat completions)

Other flags: --output <file>, --help.