Skip to content

Build the Electron.js Frontend Overlay #36

Description

@sahoo-tech

Labels: hard enhancement gssoc-2026

Build the actual desktop UI — an always-on-top, semi-transparent overlay that displays Execra's guidance in real time over the user's screen while they work.

What you'll code:

  • Set up Electron.js app in frontend/overlay/:
    • main.js — create the always-on-top, frameless, semi-transparent BrowserWindow
    • preload.js — expose WebSocket bridge to the renderer via contextBridge
    • renderer/index.html + renderer/app.js — the guidance UI
  • UI must display:
    • Current instruction text (animated fade-in on new instruction)
    • Confidence bar (coloured: green ≥85%, orange 65–84%, red <65%)
    • Step counter: "Step 4 of 9"
    • Source tags: LLM Rule Engine Trace (pill badges)
    • Error alerts: red banner with severity icon
    • Mode indicator pill: PASSIVE / ACTIVE / MIXED
  • Connect to ws://localhost:8000/ws/guidance and handle all server event types
  • Add minimize/expand toggle button
  • Add Active Mode text input (shown only in active or mixed mode)
  • Style: dark glass-morphism — background: rgba(10, 10, 20, 0.85) with blur

Skills needed: JavaScript · Electron.js · WebSocket · CSS (glass-morphism) · UI/UX

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions