# Project pack: Blinko @ b2586d0

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

> Blinko is a self-hosted note capture tool for fleeting ideas. You jot thoughts as cards, tag them, and later search by meaning using an AI model you choose, including local models. It also offers a daily review, a hub for sharing, and apps for desktop and phone.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Hosted alternative, **the person's choice, never a default**: Blinko Cloud (https://blinko.space); cost/account: paid or account-based; price not verified here.
- Verdict source: https://blinko.space
- 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/blinkospace/blinko
- Pinned commit: `b2586d03fddb796252f050a96922879bf4a41fad`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/blinkospace/blinko/archive/b2586d03fddb796252f050a96922879bf4a41fad.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://docs.blinko.space
- Licence: **GPL-3.0-only**. Free to use and change. If you share your changed version with other people (give them the code or app), you must share your source code under the same licence. Using it privately for yourself or your household has no extra obligations.

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

  ```sh
  git clone https://github.com/blinkospace/blinko bespoke-blinko
  cd bespoke-blinko
  git checkout --detach b2586d03fddb796252f050a96922879bf4a41fad
  # Prepare development requirements and local configuration first.
  bun install
  cp .env.example .env
  bun run dev:backend
  bun run dev:frontend
  ```

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

  ```sh
  curl -fsSL https://raw.githubusercontent.com/blinkospace/blinko/main/install.sh | bash
  # read the script before running it. It starts Blinko with Docker on http://localhost:1111
  ```
- Tools these commands use: Docker for a trial, Bun and Postgres for development
- Develop: `bun run dev:backend  # and, in another terminal: bun run dev:frontend`
- Test: `bun run test`
- Build: `bun run build:web`
- Stack: typescript (React, Vite, Express, tRPC, Prisma, Tauri, Bun, Turborepo). Difficulty for a non-developer with an AI: **moderate**. A TypeScript monorepo with a React front end and an Express and Prisma back end. AI provider, tags and appearance are settings; new features touch both sides.
- The project's own AI instructions, in the repository: `CLAUDE.md`.
Personal data: **yes**. Stored in: Postgres database plus an uploads folder (Docker volumes). Secrets are entered by the person, never in chat.

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