Otter is a self-hosted bookmark manager and media tracker built with React, Supabase, and Cloudflare Workers
- Private bookmarking app with search, tagging, collections, and filtering
- Starred items and public/private visibility per bookmark
- Dark/light colour modes
- Media tracking — kanban-style board for tracking movies, TV shows, games, and more
- AI-powered title and description rewriting via Cloudflare Workers AI
- RSS feed parsing and URL scraping
- Mastodon integration — backup your own toots and favourite toots
- Cross-browser web extension (Chrome & Firefox)
- Raycast extension to search, view, and create bookmarks
- Native macOS/iOS app
- Bookmarklet
| Feed (dark mode) |
Feed (light mode) |
|---|---|
| New bookmark |
Search |
| Feed (showing tags sidebar) |
Toots feed |
This is a pnpm monorepo containing the following packages:
| Package | Description |
|---|---|
packages/web |
Web app and Hono API on Cloudflare Workers |
packages/app |
Native macOS/iOS app |
packages/web-extension |
Cross-browser extension (Chrome & Firefox) |
packages/raycast-extension |
Raycast extension |
packages/chrome-extension |
Legacy Chrome extension (superseded by web-extension) |
- pnpm v10+ — install with
corepack enable && corepack prepare pnpm@latest --activate - Supabase account and the Supabase CLI
- Cloudflare account — used for hosting, Workers AI, and the API
For a full walkthrough — including Supabase database setup, Cloudflare configuration, and deployment — see the Setup Instructions.
pnpm install
pnpm web:devOtter uses semantic-release with the semantic-release-monorepo plugin to version each package independently based on Conventional Commits. Packages are not published to npm — releases are GitHub releases only.
| Prefix | Release type |
|---|---|
fix: |
Patch (1.0.x) |
feat: |
Minor (1.x.0) |
feat!: or BREAKING CHANGE: |
Major (x.0.0) |
Each releasable package has its own release.config.mjs that extends semantic-release-monorepo. The plugin filters commits to those that touch files inside the package's directory, so a commit changing only packages/web will only bump and release @mrmartineau/otter-web.
Releasable packages:
@mrmartineau/otter-web— tags as@mrmartineau/otter-web@vX.Y.Z@mrmartineau/otter-chrome-extension— tags as@mrmartineau/otter-chrome-extension@vX.Y.Z@mrmartineau/otter-web-extension— tags as@mrmartineau/otter-web-extension@vX.Y.Z
The app and raycast-extension packages are released through their own platforms (App Store / Raycast Store) and are not part of this workflow.
Releases are triggered manually via the "Release" workflow in GitHub Actions (.github/workflows/release.yml). The workflow:
- Installs dependencies
- Runs
semantic-releaseinside each releasable package viapnpm --filter ... exec semantic-release - For each package with relevant new commits: bumps
package.json, updates that package'sCHANGELOG.md, commits the bump back tomain, and creates a GitHub release with package-scoped tag and notes
GITHUB_TOKEN is provided automatically by GitHub Actions — no additional secrets required.
To target a specific package, use a Conventional Commits scope, e.g. feat(web): ... or fix(chrome-extension): .... The plugin uses changed file paths (not the scope) to decide which package releases, but scopes make the changelog clearer.
- Frontend: React 19, TanStack Router, React Query, Tailwind CSS v4
- API: Hono on Cloudflare Workers with AI bindings
- Database: Supabase (Postgres)
- Hosting: Cloudflare
- Tooling: pnpm workspaces, Biome (formatting & linting), Vite
Made by Zander • zander.wtf • GitHub • Mastodon