Pincase

Pincase is a Pinboard.in client for iOS. Protocol Launcher allows you to generate Pincase x-callback-url links.

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.

Notes

Pincase's official API page documents only these URL scheme actions:

• pincaseapp://x-callback-url/add
• pincaseapp://x-callback-url/open

For add, the official parameter table lists url, title, private, toread, noui, x-success, x-error, and x-cancel. The same official page's add-bookmark example uses later=yes; addBookmark() serializes either toread or later only when you pass that key and does not infer one from the other.

For open, Pincase documents mode, tag, and username. It also says x-source, x-success, x-error, and x-cancel will not work for this action, so the open helpers do not accept callback options. Official mode values are menu, personal_unread, personal_recent, personal_tag, public_popular, public_recent, public_japanese, public_wikipedia, public_fandom, public_favorite_stream, public_tag, and public_username. The official parameter row says tag is used with mode=personal_tag or mode=public_tag; openTag() is limited to those two values.

Add Bookmark

On-Demand

import { addBookmark } from 'protocol-launcher/pincase'

const url = addBookmark({
  url: 'http://pincaseapp.com/',
  title: 'Pincase - A simple, elegant and powerful Pinboard.in client for iOS',
  noui: 'yes',
  later: 'yes',
})

Add Bookmark in Pincase

Add Bookmark with Callbacks

On-Demand

import { addBookmark } from 'protocol-launcher/pincase'

const url = addBookmark({
  url: 'https://www.example.com/article?ref=url scheme',
  title: 'Example Article',
  private: 'no',
  toread: 'no',
  noui: 'no',
  xSuccess: 'myapp://success',
  xError: 'myapp://error',
  xCancel: 'myapp://cancel',
})

Add Bookmark with Callbacks in Pincase

Open Public Tag

On-Demand

import { open } from 'protocol-launcher/pincase'

const url = open({
  mode: 'public_tag',
  tag: 'iOS',
})

Open Public Tag in Pincase

Open Unread

On-Demand

import { openUnread } from 'protocol-launcher/pincase'

const url = openUnread()

Open Unread in Pincase

Open Recent

On-Demand

import { openRecent } from 'protocol-launcher/pincase'

const url = openRecent()

Open Recent in Pincase

Open Tag

On-Demand

import { openTag } from 'protocol-launcher/pincase'

const url = openTag({
  mode: 'personal_tag',
  tag: 'reading list',
})

Open Tag in Pincase

Generated URLs

addBookmark({
  url: 'http://pincaseapp.com/',
  title: 'Pincase - A simple, elegant and powerful Pinboard.in client for iOS',
  noui: 'yes',
  later: 'yes',
})
// => 'pincaseapp://x-callback-url/add?url=http%3A%2F%2Fpincaseapp.com%2F&title=Pincase%20-%20A%20simple%2C%20elegant%20and%20powerful%20Pinboard.in%20client%20for%20iOS&noui=yes&later=yes'

addBookmark({
  url: 'https://www.example.com/article?ref=url scheme',
  title: 'Example Article',
  private: 'no',
  toread: 'no',
  noui: 'no',
  xSuccess: 'myapp://success',
  xError: 'myapp://error',
  xCancel: 'myapp://cancel',
})
// => 'pincaseapp://x-callback-url/add?url=https%3A%2F%2Fwww.example.com%2Farticle%3Fref%3Durl%20scheme&title=Example%20Article&private=no&toread=no&noui=no&x-success=myapp%3A%2F%2Fsuccess&x-error=myapp%3A%2F%2Ferror&x-cancel=myapp%3A%2F%2Fcancel'

open({ mode: 'public_tag', tag: 'iOS' })
// => 'pincaseapp://x-callback-url/open?mode=public_tag&tag=iOS'

openUnread()
// => 'pincaseapp://x-callback-url/open?mode=personal_unread'

openRecent()
// => 'pincaseapp://x-callback-url/open?mode=personal_recent'

openTag({ mode: 'personal_tag', tag: 'reading list' })
// => 'pincaseapp://x-callback-url/open?mode=personal_tag&tag=reading%20list'

Official Documentation

• Pincase URL Schemes