Focus

Focus is a productivity and Pomodoro timer app. Protocol Launcher allows you to generate deep links to add and delete tasks, start timers, and pause the current timer in Focus.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Add Task

On-Demand

import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Read chapter 3',
})

Add Task

Add Task with Estimate

On-Demand

import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Prepare Presentation',
  note: 'Referecene mail notes',
  sessionEstimate: 8,
  due: 'monday',
})

Add Estimated Task

Add Task with Minutes Estimate

On-Demand

import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Study documentation',
  note: 'make notes',
  minutesEstimate: 120,
  due: 'tomorrow',
})

Add Task with Minutes

Delete Task

On-Demand

import { deleteTask } from 'protocol-launcher/focus'

const url = deleteTask({
  id: 'B1127BC6-3CC3-4AC4-B561-3CD493D2EDD6',
})

Focus also supports deleting multiple tasks with a single ids string separated by ?.

On-Demand

import { deleteTask } from 'protocol-launcher/focus'

const url = deleteTask({
  ids: 'B1127BC6-3CC3-4AC4-B561-3CD493D2EDD6?U36SAM-3CD3-1BC4-B481-2CD590D2EDD2',
})

Start Timer

On-Demand

import { startTimer } from 'protocol-launcher/focus'

const url = startTimer()

Start Timer

Start Timer with Duration

On-Demand

import { startTimer } from 'protocol-launcher/focus'

const url = startTimer({
  type: 'focus',
  duration: 40,
})

Start Focus Timer

Pause Timer

On-Demand

import { pauseTimer } from 'protocol-launcher/focus'

const url = pauseTimer()

Pause Timer

x-callback-url

Focus supports x-success and x-error callback parameters on every command. The add command returns the new task id as id on the x-success callback.

On-Demand

import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Read chapter 3',
  xSuccess: 'shortcuts://x-callback-url/run-shortcut?name=Focus Added',
  xError: 'shortcuts://x-callback-url/run-shortcut?name=Focus Error',
})