Desktop integrations

Native app behavior should stay explicit in the source. This chapter adds permissions, notifications, clipboard access, and a small application menu without leaving the web programming model.

Enable the capabilities

Permissions belong in configuration so reviewers can see what the app asks the host to do.

[permissions]
allow_notifications = true
allow_clipboard = true

Notify when work is saved

Ask for permission once, then send notifications for user-visible outcomes.

import Notification, { showNotification } from 'oro:notification'

const permission = await Notification.requestPermission()

async function notifySaved(note) {
  if (permission !== 'granted') return

  await showNotification('Field note saved', {
    body: note.title,
  })
}

Copy a useful summary

Clipboard actions are best when they match a clear user command.

import { writeText, canWriteText } from 'oro:clipboard'

async function copySummary(note) {
  if (!canWriteText()) return

  await writeText(`${note.title}\n${note.updatedAt}`)
}

Add a menu command

Desktop menus should mirror high-frequency UI actions, not duplicate every button.

import application from 'oro:application'

await application.setSystemMenu({
  index: 0,
  value: `
    File:
      New Note: n + Meta;
      Quit: q + Meta;
    Edit:
      Copy Summary: c + Meta;
  `,
})

What changed

• Permissions moved into reviewed config.
• Notifications became tied to saved work.
• Clipboard access became an explicit command.
• The native menu matched the app's repeated actions.