# Project pack: Joplin @ 94168d3

Facts about **Joplin** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Joplin is a note-taking and to-do app for desktop, mobile and the terminal. Notes are written in Markdown, organised in notebooks with tags, and can be synced through Dropbox, OneDrive, Nextcloud, WebDAV or Joplin's own server, with end-to-end encryption. A large plugin library and a web clipper make it easy to shape to your own way of working.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Install the project's own desktop app or installer. No Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://raw.githubusercontent.com/laurent22/joplin/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/laurent22/joplin
- Pinned commit: `94168d33d6a9564006ab8254b990d365de263ef7`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/laurent22/joplin/archive/94168d33d6a9564006ab8254b990d365de263ef7.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://joplinapp.org/help
- Licence: **AGPL-3.0-or-later**. Free to use and change. If other people use your changed version, including over a network (for example a website you host for them), you must offer them your source code under the same licence. Using it privately for yourself or your household has no extra obligations. The Joplin Server code in packages/server has its own separate licence file; check it before running a server for other people.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/laurent22/joplin bespoke-joplin
  cd bespoke-joplin
  git checkout --detach 94168d33d6a9564006ab8254b990d365de263ef7
  # Prepare development requirements and local configuration first.
  corepack enable
  yarn install
  cd packages/app-desktop
  yarn start
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  Download the desktop app from https://joplinapp.org/download, then add it to your own sync service in Settings → Synchronisation.
  ```
- Tools these commands use: Node 22 and Yarn (via corepack) for development, a desktop download for everyday use
- Develop: `cd packages/app-desktop && yarn start`
- Test: `yarn test`
- Check/lint: `yarn linter`
- Stack: typescript, javascript (Electron, React, React Native, Yarn workspaces). Difficulty for a non-developer with an AI: **advanced**. A very large Yarn monorepo with desktop, mobile, CLI and server apps. Most personal changes need no fork: use plugins, themes and custom CSS. Building the apps from source is slow and heavy.
- The project's own AI instructions, in the repository: `CLAUDE.md`.
Personal data: **yes**. Stored in: A local SQLite database and attachments in the Joplin profile folder on each device. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/joplin/94168d3/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/joplin/94168d3/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/joplin/94168d3/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/joplin/94168d3/r3/SKILL.md)