gitwtfhub

wtf is flaremo?

realchendahuang/flaremo — explained in plain English

Analysis updated 2026-05-18

156TypeScriptAudience · vibe coderComplexity · 3/5Setup · easy

TL;DR

A personal note-taking app that runs entirely on a free Cloudflare account, with a Memos-compatible API.

Mindmap

mindmap
  root((repo))
    What it does
      Quick note timeline
      Memos compatible API
      MCP endpoint for agents
    Tech stack
      Cloudflare Workers
      Cloudflare D1
      Cloudflare R2
      React
    Use cases
      Self host notes for free
      Import from Memos
      Let AI agents read notes
    Audience
      Vibe coders
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a personal note-taking system for free entirely on Cloudflare's infrastructure.

REASON 2

Import your existing notes from a Memos instance using the compatible API.

REASON 3

Share a specific note publicly with a revocable link.

REASON 4

Let an AI agent read and write notes through the MCP endpoint.

What's in the stack?

Cloudflare WorkersCloudflare D1Cloudflare R2ReactDrizzle

How it stacks up

realchendahuang/flaremoelectron/websitesinotrade/shioaji-pro-app
Stars156155157
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyhard
Complexity3/52/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires a free Cloudflare account with D1 and R2 access, deploy button handles resource creation.

Wtf does this do

FlareMo is a personal note taking system built to run entirely on a free Cloudflare account, with no server, no separate database to install, and no backup scripts to write. It stores your notes in Cloudflare D1, a database Cloudflare hosts for you, keeps attachments and images in Cloudflare R2 object storage, and runs its code on Cloudflare Workers, which places it on servers close to wherever you are in the world. You sign in with your own Cloudflare account rather than a separate app password. The project makes the case that Cloudflare's free tier is more than enough for personal notes: the free 5 gigabyte database can hold roughly two and a half million typical notes, and the free 10 gigabyte object storage can hold several thousand photos. It also argues Cloudflare is more reliable for this purpose than running your own device at home, since Cloudflare's storage is backed up and redundant by default, while a home hard drive or small server can fail, get stolen, or be lost in a power outage. Currently the app supports quick note taking with tags and attachments, a timeline view with an archive and trash, full text search, a Markdown editor, note revision history, and shareable public links that can be revoked. It also exposes an API compatible with a subset of the Memos note taking app, letting existing Memos clients and import and export tools work with it, plus a Model Context Protocol endpoint so AI agents can read and write notes. Deployment is meant to be simple: a one click Deploy to Cloudflare button that creates the needed resources automatically, or a runbook written specifically so an AI coding agent like Claude Code or Cursor can carry out the setup steps itself. Access control for both people and scripts is handled through Cloudflare Access rather than a token stored inside the app. The stack is React and Vite on the frontend, with Hono style routes, Zod, and Drizzle ORM on the backend, all running inside a single Cloudflare Worker.

Yoink these prompts

Prompt 1
Help me deploy FlareMo to my Cloudflare account using the one-click deploy button.
Prompt 2
Show me how to connect a Memos-compatible client to this FlareMo instance.
Prompt 3
Explain how Cloudflare Access replaces app login for this project.
Prompt 4
Walk me through setting up the MCP endpoint so an AI agent can read my notes.

Frequently asked questions

wtf is flaremo?

A personal note-taking app that runs entirely on a free Cloudflare account, with a Memos-compatible API.

What language is flaremo written in?

Mainly TypeScript. The stack also includes Cloudflare Workers, Cloudflare D1, Cloudflare R2.

How hard is flaremo to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is flaremo for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.