You can build and run the Ferritepool frontend and proxy to the production Ferritepool backend (for easier frontend development), or you can connect it to your own backend for a full Ferritepool 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 Ferritepool frontend locally and proxy to the ferritecoin.com backend.
Get the latest Ferritepool code:
git clone https://github.com/ferritecoin/fecspace
cd ferritepool
The same frontend codebase is used for https://ferritecoin.com and https://explorer.ferritecoin.com.
Configure the frontend for the site you want by running the corresponding command:
$ npm run config:defaults:mempool
Make sure to use Node.js 16.10 and npm 7.
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://ferritecoin.com.
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 Ferritepool backend first, if you haven't already.
Make sure to use Node.js 16.10 and npm 7.
Build the frontend:
cd frontend
npm install
npm run build
To run your local Ferritepool frontend with your local Ferritepool 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.
Ferritepool merges translations from upstream, so please help through the link below. 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