Community-contributed
Add or edit a place
Every entry is a Markdown file in the repo. No database, no CMS login. Fork, write, pull request. If you've worked from a place and want others to know -- this is how.
New place
Add a place you know
Create a new Markdown file from the template. One file = one place.
Open GitHub → New File →
Edit / fix
Fix or update existing info
WiFi speed changed? New hours? Wrong price? Find the file and open a PR.
Browse existing entries ↗ →
How it works
01
Fork the repo
Go to the GitHub repo and fork it to your account. You'll push changes from your fork.
02
Create or edit a Markdown file
Each place lives at content/places/<slug>.md. Copy the template below, fill in real data only -- no guessing.
03
Add your review block
At the bottom of the file, add a review entry with your GitHub handle and today's date. Be specific -- 'WiFi was stable for a 2-hour Zoom call' beats 'great wifi'.
04
Open a Pull Request
Submit a PR to main. The maintainers will review for completeness and merge. Build runs automatically -- your place goes live.
Place template (.md)
---
name: "Nama Kafe"
city: "Yogyakarta"
short_desc: "One-sentence pitch: what makes this place worth knowing about."
ambience: "quiet" # quiet | moderate | lively | loud
ambience_timeline:
morning: "quiet" # quiet | moderate | lively | loud
afternoon: "moderate"
evening: "lively"
night: "loud"
wifi:
speed: 85 # Mbps, measure with Fast.com or Speedtest
isp: "Biznet"
sockets: "available" # available | limited | none
smoking: "none" # none | outdoor | indoor | indoor-outdoor
open_hours:
open: "08:00" # HH:MM format
close: "22:00"
open_hours_type: # pick all that apply
- morning-friendly # opens by 08:00
- daytime-stable
# - late-night-viable # closes after 23:00
google_maps: "https://maps.google.com/?q=..."
disabled_friendly: false
last_edit:
author: your-github-handle
date: "YYYY-MM-DD"
drinks:
- name: "Americano"
price: 22
- name: "Kopi Susu"
price: 25
food:
- name: "Roti Bakar"
price: 20
perks:
- "Fast and stable WiFi"
- "Many power sockets"
limitations:
- "Noisy after 7pm"
- "Limited sockets near windows"
do:
- "Come before noon for quiet hours"
dont:
- "Take calls without headphones after 6pm"
# tags: [] # optional: free-form tags
reviews:
- text: "Your honest, specific review. Not an ad."
author: your-github-handle
date: "YYYY-MM-DD"
---
Field reference
Content rules
Do
+Only list places you've personally worked from
+Measure WiFi speed with Fast.com or Speedtest
+Add your GitHub handle to the review block
+Keep reviews short and specific -- 1-2 sentences
+Update the last_edit date when you change anything
Don't
--Copy from Google Maps reviews -- write from experience
--Invent or guess WiFi speeds
--Add a place you haven't visited
--Write promotional descriptions
--Leave the template fields blank or as placeholders
Something wrong with an entry?
Open a GitHub issue -- flag the place name and what's outdated or incorrect.