Skip to content

Gladys

Gladys is a drag-and-drop shelf app for iPad that holds things you want to set aside, such as links, text snippets, map locations, contacts, images, photos, emails, messages and much more. Protocol Launcher allows you to generate deep links to create items and paste from clipboard in Gladys.

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.

Create Item with Text

On-Demand
ts
import { createItem } from 'protocol-launcher/gladys'

const url = createItem({
  text: 'Hi There',
  title: 'Greeting',
  labels: 'Created Items,New Items',
  note: 'Some Notes',
})

Create Item with URL

On-Demand
ts
import { createItem } from 'protocol-launcher/gladys'

const url = createItem({
  url: 'http://bru.build',
  title: 'The Gladys Guy',
  labels: 'Developer,iOS,macOS,Embedded',
  note: 'Some Notes',
})

Create Item with Base64 Data

On-Demand
ts
import { createItem } from 'protocol-launcher/gladys'

const url = createItem({
  base64data: 'RXhhbXBsZSB0ZXh0IGZpbGUuCg==',
  title: 'Test.txt',
  labels: 'Text Files',
  note: 'Pretending I am a file',
})

Paste Clipboard

On-Demand
ts
import { pasteClipboard } from 'protocol-launcher/gladys'

const url = pasteClipboard()

Paste Clipboard with Title

On-Demand
ts
import { pasteClipboard } from 'protocol-launcher/gladys'

const url = pasteClipboard({
  title: 'Override The Title',
})

Paste Clipboard with Labels and Note

On-Demand
ts
import { pasteClipboard } from 'protocol-launcher/gladys'

const url = pasteClipboard({
  title: 'Override The Title',
  labels: 'Pasted Items,New Items',
  note: 'Some Notes',
})