{
  "manifest": {
    "spekkr": 1,
    "id": "dwrtz/async-video",
    "name": "Async video",
    "summary": "Record your screen and camera in the browser, share a link, get comments and emoji pinned to the moment. Cloudflare Workers, R2 and D1.",
    "keywords": [
      "video",
      "screen recording",
      "webcam",
      "async video",
      "video messaging",
      "mediarecorder",
      "comments",
      "react",
      "cloudflare workers",
      "r2",
      "d1",
      "video editing"
    ],
    "kind": "web app",
    "version": "0.1.2",
    "author": {
      "id": "dwrtz",
      "name": "David Wurtz"
    },
    "targets": {
      "platforms": [
        "web",
        "backend"
      ],
      "stack": [
        "TypeScript",
        "Cloudflare Workers",
        "Cloudflare R2",
        "Cloudflare D1",
        "Wrangler",
        "React",
        "Vite",
        "MediaRecorder",
        "Mediabunny",
        "WebCodecs",
        "Vitest",
        "Playwright"
      ]
    },
    "customize": {
      "settings": [
        {
          "key": "app_name",
          "label": "Product name",
          "default": "Async Video",
          "help": "Shown in the top bar, page titles and on the sign-in page."
        },
        {
          "key": "accent_color",
          "label": "Accent colour",
          "default": "#0d9488",
          "help": "As #rrggbb. Primary buttons, the big play button, the seek bar, timestamps and focus rings."
        },
        {
          "key": "allowed_emails",
          "label": "Who may have an account",
          "default": "",
          "help": "Comma-separated emails allowed to sign up and sign in (checked on the server). Empty lets anyone sign up. Shared links stay public either way."
        }
      ]
    },
    "files": [
      {
        "path": "spec.md",
        "about": "Requirements R1–R17 with acceptance checks: allowlisted accounts, recorder with camera bubble, review before saving with real cuts made in the browser (trim, removed section, mute; only the kept part is uploaded), MP4-first recording, multipart upload, share page and player that plays on phones, re-cutting a saved video, chapters, timestamped comments, reactions, views, library, limits, phones, deploy."
      },
      {
        "path": "design.md",
        "about": "Stack, Cloudflare config and deploy steps, data model and migrations (including the two-step live upgrade to real cuts), R2 layout, recording pipeline, WebM header repair, review step, in-browser cutting with WebCodecs and a real-time fallback, the replace API and time remapping, upload protocol, API, player details, screens and look, test setup including ffprobe and timecode checks."
      },
      {
        "path": "tasks.md",
        "about": "Build tasks in order, each with a check, plus testing notes for fake media devices and for proving cuts."
      },
      {
        "path": "research.md",
        "about": "What the design was modelled on, how it was studied, where it differs (including why cuts are made in the browser), the mobile playback investigation, and how each version was checked."
      }
    ],
    "needs": {
      "permissions": [
        "shell",
        "network"
      ]
    },
    "demo": {
      "screenshots": [
        "shots/share-page.png",
        "shots/review-editor.png",
        "shots/recorder.png",
        "shots/library.png",
        "shots/edit-trim-chapters.png",
        "shots/cut-confirm.png",
        "shots/comment-and-react.png",
        "shots/dark-mode-chapters.png",
        "shots/sign-in.png",
        "shots/mobile.png"
      ]
    },
    "safety": {
      "commands": [
        "npm install",
        "npx wrangler d1 migrations apply DB --local",
        "npx wrangler dev",
        "npx playwright install chromium",
        "npx playwright install webkit"
      ]
    },
    "lineage": {},
    "changelog": [
      {
        "version": "0.1.2",
        "date": "2026-11-17",
        "note": "Real cuts. Saving a trimmed, cut or muted recording now makes a new MP4 in the browser (WebCodecs through Mediabunny, faster than real time, with a real-time MediaRecorder fallback) and uploads only the kept part, so cut parts and muted sound never leave the device; cutting shows progress and can be cancelled, and a recording without edits uploads as it is. Edit video re-cuts a saved video: it downloads the file, cuts it, uploads a new copy and deletes the old one after a confirmation that it can't be undone; chapters, comments and reactions move with the video. The player plays the file as it is, downloads equal what viewers see, and muted videos can be downloaded again. Migration 0003 adds the new file columns and drops 0.1.1's trim, cut and mute columns. Requirements R3a, R5–R8, R13, R15 and the tests updated; new R7a; E2E tests check stored files with ffprobe and a timecode drawn into the recording."
      },
      {
        "version": "0.1.1",
        "date": "2026-11-16",
        "note": "Videos play on phones: recordings are MP4 (H.264) first, WebM is written with valid sizes, WebM saved by 0.1.0 is repaired as it's served (the stored file is untouched), and browsers that can't play a format get a notice with a download. New review step after Stop: nothing uploads until Save; trim the start and end, remove one middle section, set the title and mute, or discard and record again. The recorder tab is left out of the screen picker, a shared tab or window gets focus, floating controls (Document Picture-in-Picture) and Alt+Shift+S stop the recording. Phones record with the camera and say why screen modes are off. Requirements R3–R7, R13 and R15 and the tests updated; new R3a, R3b and R6a checks and a WebKit (iPhone 13) project."
      },
      {
        "version": "0.1.0",
        "date": "2026-11-16",
        "note": "First version."
      }
    ]
  },
  "links": {
    "page": "./",
    "bundle": "bundle.tar.gz",
    "files": {
      "design.md": "files/design.md",
      "research.md": "files/research.md",
      "shots/comment-and-react.png": "files/shots/comment-and-react.png",
      "shots/cut-confirm.png": "files/shots/cut-confirm.png",
      "shots/dark-mode-chapters.png": "files/shots/dark-mode-chapters.png",
      "shots/edit-trim-chapters.png": "files/shots/edit-trim-chapters.png",
      "shots/library.png": "files/shots/library.png",
      "shots/mobile.png": "files/shots/mobile.png",
      "shots/recorder.png": "files/shots/recorder.png",
      "shots/review-editor.png": "files/shots/review-editor.png",
      "shots/share-page.png": "files/shots/share-page.png",
      "shots/sign-in.png": "files/shots/sign-in.png",
      "spec.md": "files/spec.md",
      "tasks.md": "files/tasks.md"
    }
  },
  "publishedBy": "dwrtz",
  "uploaded": {
    "shots/comment-and-react.png": {
      "bytes": 887715,
      "type": "image/png"
    },
    "shots/cut-confirm.png": {
      "bytes": 641396,
      "type": "image/png"
    },
    "shots/dark-mode-chapters.png": {
      "bytes": 719355,
      "type": "image/png"
    },
    "shots/edit-trim-chapters.png": {
      "bytes": 805098,
      "type": "image/png"
    },
    "shots/library.png": {
      "bytes": 759367,
      "type": "image/png"
    },
    "shots/mobile.png": {
      "bytes": 376907,
      "type": "image/png"
    },
    "shots/recorder.png": {
      "bytes": 684235,
      "type": "image/png"
    },
    "shots/review-editor.png": {
      "bytes": 448483,
      "type": "image/png"
    },
    "shots/share-page.png": {
      "bytes": 743350,
      "type": "image/png"
    },
    "shots/sign-in.png": {
      "bytes": 1069664,
      "type": "image/png"
    }
  }
}
