Audio Recorder Pro Mobile - Instructions
1. Recorder element

2. Recorder fields
Max file size MB
Use this to limit the maximum recording file size in MB. Leave empty or set to 0 for no file size limit.

Limit in seconds
Use this to limit the recording duration. Leave empty or set to 0 for no duration limit.

Permission on load
When yes, the plugin requests microphone permission when the recorder element mounts.

Save to Bubble storage
When yes, the plugin uploads the final audio file to Bubble storage. When no, the plugin publishes the local recorded file URI.

App name
Your Bubble app name or domain. Examples: myapp, myapp.bubbleapps.io, or https://mycustomdomain.com.

App version
Use test or live. Test uploads to /version-test/fileupload. Live uploads to /fileupload.

3. Recorder actions
Record
Starts a new recording. If the recording is paused, calling Record continues the paused recording.

Pause
Pauses the current recording.

Resume
Continues the paused recording from where it stopped.

Stop
Stops the recording, publishes the final duration and file size, updates recording states, and prepares or uploads the final file.

Reset
Clears the current recording and resets the recorder states.

Request microphone permission
Requests microphone permission. If permission remains denied, the plugin attempts to open the app/device settings so the user can allow microphone access manually.

4. Recorder states
File
The final audio file URL when saved to Bubble storage, or the local file URI when storage upload is disabled.

Duration
Recording duration in seconds.

Is recording
Yes when the recorder is actively recording.

Is paused
Yes when the current recording is paused.

Is stopped
Yes when the recorder is stopped.

Error
The latest error message, if any.

Microphone permission
Yes when microphone permission is granted.

File size
The final file size in MB.

Upload progress
Upload progress number. Useful when saving to Bubble storage.

5. Recorder events
Is recording
Triggered when recording starts or resumes.

Is paused
Triggered when recording pauses.

Is stopped
Triggered when recording stops.

File is available
Triggered when the final file URL or URI is available.

Microfone permission is granted
Triggered when microphone permission is granted.

6. Saving recordings to Bubble storage

7. Wave Sound element

8. Wave Sound fields
Bg color
Background color of the Wave Sound element. Example: #0b1020.

Wave color
Color of the animated waveform bars. Example: #38bdf8.

Border style
Can be None, Solid, Dotted, or Dashed. If different from None, the border is shown with 1px width.

Border radius
Border radius number. Empty uses 6.

Border color
Border color. If empty, the plugin uses the Wave color.

9. Recommended workflow setup
1. Add the Recorder element to the page.
2. Optional: set Permission on lod to yes.
3. Create a Record button and run the Record action.
4. Create a Pause button and run the Pause action.
5. Create a Resume button and run the Resume action.
6. Create a Stop button and run the Stop action.
7. Use File is available to save or display the final audio file.
8. Use Error for user-facing error handling.
9. Add the Wave Sound element if you want a live microphone visualizer.

10. Important notes