You can build and run the Mempool frontend and proxy to the production Mempool backend (for easier frontend development), or you can connect it to your own backend for a full Mempool development instance, custom deployment, etc.
Jump to a section in this doc:
If you want to quickly improve the UI, fix typos, or make other updates that don't require any backend changes, you don't need to set up an entire backend—you can simply run the Mempool frontend locally and proxy to the mempool.space backend.
Get the latest Mempool code:
git clone https://github.com/mempool/mempool
cd mempool/frontend
The same frontend codebase is used for https://mempool.space and https://liquid.network.
Configure the frontend for the site you want by running the corresponding command:
$ npm run config:defaults:mempool
$ npm run config:defaults:liquid
Make sure to use Node.js 20.x and npm 9.x or newer.
Install project dependencies and run the frontend server:
$ npm install
$ npm run serve:local-prod
The frontend will be available at http://localhost:4200/ and all API requests will be proxied to the production server at https://mempool.space.
After making your changes, you can run our end-to-end automation suite and check for possible regressions.
Headless:
$ npm run config:defaults:mempool && npm run cypress:run
Interactive:
$ npm run config:defaults:mempool && npm run cypress:open
This will open the Cypress test runner, where you can select any of the test files to run.
If all tests are green, submit your PR, and it will be reviewed by someone on the team as soon as possible.
Set up the Mempool backend first, if you haven't already.
Make sure to use Node.js 20.x and npm 9.x or newer.
Build the frontend:
cd frontend
npm install
npm run build
To run your local Mempool frontend with your local Mempool backend:
npm run serve
The npm run build command from step 1 above should have generated a dist directory. Put the contents of dist/ onto your web server.
You will probably want to set up a reverse proxy, TLS, etc. There are sample nginx configuration files in the top level of the repository for reference, but note that support for such tasks is outside the scope of this project.
The Mempool frontend strings are localized into 20+ locales: https://www.transifex.com/mempool/mempool/dashboard/
- Arabic @baro0k
- Czech @pixelmade2
- Danish @pierrevendelboe
- German @Emzy
- English (default)
- Spanish @maxhodler @bisqes
- Persian @techmix
- French @Bayernatoor
- Korean @kcalvinalvinn @sogoagain
- Italian @HodlBits
- Lithuanian @eimze21
- Hebrew @rapidlab309
- Georgian @wyd_idk
- Hungarian @btcdragonlord
- Dutch @m__btc
- Japanese @wiz @japananon
- Norwegian @T82771355
- Polish @maciejsoltysiak
- Portugese @jgcastro1985
- Slovenian @thepkbadger
- Finnish @bio_bitcoin
- Swedish @softsimon_
- Thai @Gusb3ll
- Turkish @stackmore
- Ukrainian @volbil
- Vietnamese @BitcoinvnNews
- Chinese @wdljt
- Russian @TonyCrusoe @Bitconan
- Romanian @mirceavesa
- Macedonian @SkechBoy
- Nepalese @kebinm