git404hub

what is cafeblr fr?

amalshaji/cafeblr — explained in plain English

Analysis updated 2026-05-18

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

tl;dr

A crowdsourced website of Bengaluru cafes sourced entirely from loved X posts, with an AI agent skill that automates adding new entries.

vibe map

mindmap
  root((cafeblr))
    What it does
      Crowdsourced cafe directory
      Sourced from X posts
      Links to original posts
    Tech stack
      TypeScript
      Astro
      Bun
      Cloudflare Workers
    Use cases
      Find nice cafes in Bengaluru
      Submit cafes via GitHub issue
      Automate submissions with AI skill
    Audience
      Cafe explorers
      Contributors and agents
    Status
      Actively maintained
      Deployed on main branch push

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

what do people make with this?

VIBE 1

Browse a curated, crowdsourced list of loved cafes in Bengaluru with directions.

VIBE 2

Suggest a new cafe by submitting an X post link through a GitHub issue.

VIBE 3

Install the project's skill so an AI coding agent can auto-process cafe submissions into pull requests.

what's the stack?

TypeScriptAstroBunCloudflare Workers

how it stacks up fr

amalshaji/cafeblraliansari22/pdfcleararpitbhalla/ts-backend
Stars333
LanguageTypeScriptTypeScriptTypeScript
Last pushed2022-06-09
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencevibe codergeneraldeveloper

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

how do i run it?

Difficulty · easy time til it works · 30min

in plain english

Cafe BLR is a small website that lists nice cafes in Bengaluru, India, but with an unusual twist on how the list gets built. Instead of a team of editors picking cafes, every entry comes from a post on X, formerly known as Twitter, that people genuinely loved. Each cafe card on the site links back to the original post so visitors can see the receipts for themselves, plus a Google Maps link for directions. The entire database behind the site is a single JSON file listing every cafe with details like its name, neighborhood, what people liked about it, a photo, and a link to the original post it came from. The site itself is built with Astro, a tool for building fast websites, and every cafe page is generated ahead of time when the site is built, with search and filtering handled by a small amount of JavaScript that runs in the visitor's browser. The site is deployed on Cloudflare Workers, and every push to the main branch automatically rebuilds and redeploys it. Anyone can suggest a new cafe by opening a GitHub issue and pasting the link to the X post that mentions it. From there, either a maintainer or an AI coding agent reviews the post, fetches the photo and details, and adds it to the list. The project even ships a small tool, called a skill, that lets AI coding assistants like Claude Code or Cursor process a submitted post automatically: it fetches the tweet, builds the correct entry, checks it against the project's rules, and opens a pull request on its own. There are clear rules enforced by automated checks before any new entry is accepted, covering things like unique IDs, valid image links, and making sure the original post still exists. The project credits the original poster on every card and will remove content if the poster asks. No official X API key is needed since it reads public post pages directly.

prompts (copy fr)

prompt 1
Show me how to add a new cafe entry to data/cafes.json following the project's validation rules.
prompt 2
Explain how this Astro site prerenders cafe pages and handles client-side search filtering.
prompt 3
Help me install the add-to-cafeblr skill and use it to process a submitted tweet link.
prompt 4
Walk me through setting up local development with Bun and Astro for this project.

Frequently asked questions

what is cafeblr fr?

A crowdsourced website of Bengaluru cafes sourced entirely from loved X posts, with an AI agent skill that automates adding new entries.

What language is cafeblr written in?

Mainly TypeScript. The stack also includes TypeScript, Astro, Bun.

How hard is cafeblr to set up?

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

Who is cafeblr for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.