Tape Format

tape.yaml is the source recipe for a mixtape.

Required Fields

title: Mobile Design Foundations
description: Core touch and gesture references for native mobile UX.
version: 1
curator: cmdux-sh
mode: quick
jtbd: When I am designing native mobile interactions, I want grounded touch guidance, so I can avoid brittle gesture patterns.

sources:
  - type: web
    url: https://developer.apple.com/design/human-interface-guidelines/gestures
    note: Apple's canonical gesture reference.
    section: foundations
    kind: reference

Required top-level fields:

title
description
version: 1
curator
sources

sources can be empty while you are drafting a tape. The terminal UI requires at least one source before compiling.

Optional Top-Level Fields

mode, either quick or methodology
tags
created
updated
license
homepage
jtbd
jtbd_clarifications
methodology_version
parent

The jtbd field uses Job Story form:

When [circumstance], I want [motivation], so I can [outcome].

Source Types

Liner supports three source types.

Web

- type: web
  url: https://example.com/article
  note: Why this source belongs.
  section: foundations
  priority: required
  kind: reference

Optional render values:

absent: try server HTML first, then use headless Chromium if needed
js: use Chromium immediately
server: use server-rendered HTML only

YouTube

- type: youtube
  url: https://www.youtube.com/watch?v=XXXX
  note: Watch for the section on source evaluation.
  section: examples

Liner tries transcript fetching first and falls back through yt-dlp where possible.

Local File

- type: local_file
  path: personal/touch-target-paper.pdf
  citation: "Parhi et al., Target Size for One-Handed Thumb Use, Mobile HCI 2006."
  note: Canonical empirical study behind small-screen touch targets.
  section: research

Local files must live under the mixtape project’s personal/ folder. Supported formats are Markdown, text, HTML, and PDF, up to 10 MB per file.

Source Fields

Common optional fields:

note: curator guidance about why the source belongs
section: source grouping used by compile filters
priority: required or optional; defaults to required
kind: reference, principle, prescription, or example

local_file sources require path and citation. Web and YouTube sources require url.