RCPA VOICE — Record, Transcribe & Send
=======================================

WHAT THIS IS
------------
A simple web app that records your voice, turns it into text live as you
speak, and lets you send that text to an email address. It is styled with
the RCPA brand (navy, yellow, the real RCPA logo).

This is a single web page, not an App Store app.


WHAT'S IN THIS FOLDER
---------------------
index.html ................ The app itself. This is the file you open.
assets/RCPA_logo.svg ...... The standard RCPA logo (navy, for light backgrounds).
assets/RCPA_logo_reversed.svg  The white RCPA logo (for dark backgrounds).
README.txt ................ This file.

(The app already has the logo built in, so it works on its own. The logo
files in the assets folder are just there for your own use.)


HOW TO TEST IT QUICKLY ON A COMPUTER (EASIEST)
----------------------------------------------
1. On a Windows PC or Mac, find the file "index.html" in this folder.
2. Right-click it and choose "Open with" then "Google Chrome"
   (or "Microsoft Edge").
   >> Please use Chrome or Edge. The live voice-to-text does NOT work in
      Safari or Firefox.
3. The app opens. Click the round microphone button.
4. Your browser will ask to use the microphone. Click "Allow".
5. Start talking. Your words appear on screen.
6. Click the microphone again to stop.
7. Type an email address in the box and click "Send". This opens your
   normal email program with the text already filled in. You press send.


THE SETTINGS BUTTON
-------------------
The gear icon (top-right) lets you save a default email address so you
don't have to type it every time. It is remembered on that device.


PUTTING IT ON AN iPHONE (with a home-screen icon)
-------------------------------------------------
An iPhone cannot make a home-screen icon from a file. The file first
needs to live at a web address. Here is the simplest free way:

1. On a computer, open a web browser and go to:  app.netlify.com/drop
2. Drag the file "index.html" onto that web page (or drag the whole
   "rcpa-voice" folder).
3. Netlify gives you a web link (a URL). Copy it.
4. On your iPhone, open the SAFARI app and type in that link.
5. Tap the Share button (square with an arrow pointing up).
6. Scroll down and tap "Add to Home Screen".
7. Tap "Add". The RCPA icon now appears on your home screen.

NOTE ABOUT iPHONE: Apple forces home-screen web apps to use Safari
underneath, and the live voice-to-text feature does not work in Safari
yet. Recording and emailing will work; the automatic transcription may
not. To make transcription work on every device (iPhone included), the
app would need to send the audio to a transcription service such as
Whisper or Deepgram. That is an extra piece that can be added.


IF SOMETHING DOESN'T WORK
-------------------------
- No words appearing? You are probably in Safari or Firefox. Use Chrome
  or Edge.
- Microphone not working? Check you clicked "Allow" when asked. Opening
  the file directly (not through a web link) can also block the mic for
  security reasons — hosting it online fixes that.
- Send button does nothing? Make sure an email address is typed in and
  that an email app is set up on the device.


QUESTIONS
---------
Ask and these can be adjusted: real Campton brand font, a dark navy/yellow
theme, multiple saved email addresses, or device-wide transcription.