Practical overview
When it fits
Use BTC Map when a map-based view of Bitcoin-accepting places is more useful than a general directory, or when you want to explore the project’s documented PWA and embedding options.
Who it is for
- People looking for locations that accept Bitcoin.
- Website and app developers seeking to embed the BTC Map interface.
- Developers working on the open-source map application.
Documented uses
- Explore a map of places that accept Bitcoin.
- Add the map to a website or application using the project’s embedding guidance.
- Run or build a local copy of the frontend.
Requirements & limits
The project describes the web application as free and open source. Its README says the PWA can be installed from a mobile browser using that browser’s add-to-home-screen or install option.
- The project is a web application with mapping topics including Leaflet and OpenStreetMap.
- The README points to a separate wiki page for map-embedding instructions.
- Local frontend development requires Node.js 24 or later and pnpm 10 or later.
- Local API development is a separate setup; the location-submission form requires BTCMAP_IMPORT_TOKEN.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run the BTC Map web app locally
Start a local development instance of the frontend.
Before you start
- A cloned copy of the btcmap.org repository
- Node.js 24 or later
- pnpm 10 or later
Steps
Clone the repository and change into its directory.
Install the project packages with pnpm install.
Start the development server with pnpm dev and open http://localhost:5000.
Expected outcome
The README says pnpm dev opens the app at the local address shown.
Guide limitations
- This guide covers frontend startup only; local API development has separate setup steps.
- No execution or compatibility testing is implied.
Build the web app
Prepare and build a local copy of the BTC Map project.
Before you start
- A cloned copy of the repository
- Node.js 24 or later
- pnpm 10 or later
Steps
Copy .env.example to a file named .env.
Run pnpm build.
Expected outcome
The documented build command is pnpm build.
Guide limitations
- The README does not specify deployment steps or a deployment destination.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- teambtcmap/btcmap.org · Official homepage title · retained in its source language