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.

License

All rights reserved, © Love Wins Media, Inc. No license of any kind is granted; see LICENSE. Works based on this site need Love Wins Media's written permission, a GitHub fork of this repository and written notice (a "Derived work notice" issue). Misrepresenting the site or Love Wins Media's work is expressly prohibited. Copies published under the earlier MIT License stay MIT for those copies.

Copying is prohibited. Copying this work beyond what LICENSE allows is copyright infringement, and willful copying can be a federal crime (17 U.S.C. §§ 501, 506). Removing, altering or faking copyright or attribution notices is unlawful under 17 U.S.C. § 1202, and a federal crime under § 1204 when done willfully for commercial advantage or private financial gain. See NOTICE.md for the details.