Skip to content

iThoughts

iThoughts is a mind-mapping app. Protocol Launcher allows you to generate deep links for iThoughts.

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.

URL Methods

The helpers below mirror the two x-callback-url actions documented by iThoughts: makeMap and amendMap.

Make Map

Convert Markdown or text into a new mind map. The documented parameters are exactly text, note, link, format, path, and style. iThoughts documents md and text as format values, and also supports [[clipboard]] in the text parameter to use the clipboard contents.

On-Demand
ts
import { makeMap } from 'protocol-launcher/ithoughts'

const markdownUrl = makeMap({
  text: '# Project\n- Collect ideas\n- Draft outline',
  note: 'Created from Markdown',
  link: 'https://www.toketaware.com/ithoughts-howto-x-callback-url',
  format: 'md',
})

const clipboardUrl = makeMap({
  text: '[[clipboard]]',
  format: 'text',
})

Amend Map

Amend an existing map by passing its path and a target topic match. iThoughts documents edit as YES or NO; YES selects the new topic and edits it.

On-Demand
ts
import { amendMap } from 'protocol-launcher/ithoughts'

const url = amendMap({
  text: 'Follow up',
  path: '/tasks',
  target: 'newtasks',
  edit: 'YES',
})

Official Documentation