Resonance

Real-time guitar tuner in the browser (React + TypeScript + Vite). Uses the Web Audio API AnalyserNode FFT for pitch detection.

Run

npm install
npm run dev

Open the URL Vite prints. Use localhost or HTTPS so the microphone works.

npm run build

Outputs to dist/.

GitHub Pages

The repo includes .github/workflows/deploy.yml: on every push to main it builds with VITE_BASE=/ (correct for the custom domain via public/CNAME) and deploys to GitHub Pages.

One-time setup (required)

If the deploy job fails with 404 / “Ensure GitHub Pages has been enabled”, the site is not wired to Actions yet:

1. Open https://github.com/RoshanGamage01/resonance/settings/pages
2. Under Build and deployment, set Source to GitHub Actions (not “Deploy from a branch”).
3. Save if GitHub shows a save control, then re-run the failed workflow (Actions → workflow run → Re-run all jobs).

URLs

• Custom domain: https://resonance.roshangamage.me/ (HTTPS works for the microphone API).
• If you need the github.io project URL (…/resonance/) instead, set VITE_BASE in the workflow to /resonance/ and drop or change public/CNAME so paths match how you host.

SEO

Canonical URL, Open Graph / Twitter meta, JSON-LD (WebSite, WebApplication), robots.txt, sitemap.xml, and manifest.webmanifest live in index.html and public/. If the site moves to another domain, update absolute URLs in those files to match.