Technical Specification

The frontend application is already fully operational and hosted on Cloudflare Pages

Goal:

Develop a cross-platform Electron application based on Nuxt.js, with:

• Using the main authorization logic similar to the main website

• Ability to record microphone + system audio

• Uploading recordings to Amazon S3 (existing functionality, just need to verify it works in Electron)

• Support for macOS + Windows

• Preparation for production distribution (.dmg, .exe)

Stage 1. Wrapping Nuxt.js in Electron:

1. Integration with the existing Nuxt application

2. Storing API token

   • Implement a procedure for exchanging API tokens similar to the frontend application, requiring authentication on the API service

3. Window functionality

   • Responsive window size

   • Minimize, close, restart

   • Support for auto-updates (in the future)

Stage 2. Audio recording (microphone + system)

1. UI

   • Add a Record now button

   • Implement device selection (if possible)

     • Input: microphone (default audio input)

     • Output: system sound (loopback)

2. Audio capture

   • Use:

     • mic or node-record-lpcm16 — for microphone

     • wasapi (Windows) or BlackHole/Loopback (macOS) — for system output

3. Recording format

   • Preferably save in .wav

4. Upload

   • After recording ends, use the existing method to upload files to S3 (verify it works)

5. Delete local file

   • After successful upload, delete the file

Stage 3. Packaging and production

Platforms:

• macOS (Intel + ARM)

• Windows (10/11)

Tasks:

• Prepare .dmg (macOS) and .exe or .msi (Windows)

• Configure productName, icons, auto-updates

• Build using electron-builder or an alternative

• Provide instructions for subsequent automated build in Github CI/CD

Stage 4. Overlay mode over active window

Goal:

Add the ability to invoke overlay mode:

• Display interface (agenda, tips, action items) above any windows

• Invoke/hide overlay with hotkey

• Use transparent Electron window with click-through (non-blocking)

• Overlay — is a separate window that opens a custom route in Nuxt (/overlay)

• Content loads via API / WebSocket

Overlay behavior