AudienceKit website

Astro source for audiencekit.com, deployed to Cloudflare Workers with Wrangler static assets.

Local development

Use Node.js 24 (or mise install):

npm ci
npm run dev

npm run check checks Astro and TypeScript. npm run build generates the static site in dist/. npm run preview serves the build; npm run preview:cloudflare builds and previews Cloudflare routing locally.

Deployment

npx wrangler login
npm run deploy

Wrangler runs the Astro build before deploying the dist/ assets to the audience-kit-github-io Worker. Unknown URLs serve the custom 404 page with a 404 status. The configured canonical site URL is https://audiencekit.com.

The GitHub Actions workflow checks and builds pull requests, and deploys pushes to main or manual runs. Configure repository secrets CLOUDFLARE_API_TOKEN (Workers deployment access) and CLOUDFLARE_ACCOUNT_ID for automated deployments. Custom domains are managed in the Cloudflare Worker settings; deploying the Worker alone does not move an existing domain from GitHub Pages.

Content and staff app links

Pages live in src/pages/, shared markup in src/components/ and src/layouts/, and static assets in public/assets/. Site settings are in src/data/config.json; the featured audience preview is in src/data/featured_audiences.json.

/apps/focus/, /apps/velvet/ and /apps/backstage/ are stable links for QR codes and posters: phones go straight to the App Store, or TestFlight while an app is in beta (iPhone/iPad), or Google Play (Android), desktops see both buttons, and ?stay shows the page on a phone. Store URLs live in src/data/staff_apps.json; change them there when an app leaves beta and printed codes keep working. python3 scripts/qr.py regenerates public/assets/qr/*.svg after adding an app (requires segno).

Onboarding invites: Focus shows QR codes for audiencekit.com/v/<code> (Velvet) and /b/<code> (Backstage). public/.well-known/apple-app-site-association lets the Velvet and Backstage App Clips and apps open them (served as JSON by public/_headers); anywhere else public/_redirects sends them to /invite/velvet/ or /invite/backstage/, which say how to get the app. Keep the AASA's app IDs in step with the staff apps' bundle IDs (team DWVXMLB45Y).

Legal copy is Markdown in src/pages/privacy/, src/pages/terms/, and src/pages/data-deletion/. Google Analytics runs only in production builds.

Link preview

The homepage share card is public/assets/brand/audiencekit-social-v1.png (1200 × 630). Its editable source is design/share-card.html, using local fonts and brand art. Render that HTML at 1200 × 630 with device scale factor 1 to regenerate the PNG. Increment the image filename and homepage reference when replacing a published card to refresh image caches.