1
Fork the repo
Go to github.com/alexgaudon/slashbrag and click the Fork button in the top-right. That's your copy now.
2
Create your entry file
Add a file to data/ called
your-name.json. Use kebab-case — the filename is your display name
(jane-doe.json → "Jane Doe").
data/your-name.json
{
"location": "City, Country",
"link": "https://yoursite.com/brag",
"description": "A short sentence about you and what you do.",
"image-url": "https://example.com/avatar.jpg", // optional
"tags": ["web-dev", "open-source"] // optional
} 3
Add coordinates
Your entry needs lat and lng fields so it shows on the map.
Run this from the project root:
npm run enrich
It geocodes your location via OpenStreetMap and writes the coordinates into your JSON file. Already-geocoded locations are cached, so re-running it is instant.
4
Submit a pull request
Commit, push to your fork, and open a pull request. Once it's merged, your page is live in the directory.
Tips
- ◆ Use City, Country format for location — it groups entries on the map and directory.
- â—† Make sure your link is a live /brag page people can actually visit.
- ◆ Keep the description short — a sentence or two. It's your intro.
- â—† Run
npm run enrichbefore committing — it addslat/lngso your entry shows on the map. - ◆ Optionally include a
"tags"array — helps people find your entry when they search. - ◆ If you want a display name different from the filename, add a
"name"field. - â—† Optionally include an
"image-url"— it shows as an avatar next to your entry.