The official website repository of BTCPay Server project.
Feel free to contribute ideas, code or content to improve the website.
Prior to submitting a major pull-request, make sure to discuss the changes with the community on #website channel on Mattermost to avoid duplicating the work.
If you're a developer looking to help, but you're not sure where to begin, check the good first issue
label, which contains small pieces of work that have been specifically flagged as being friendly to new contributors.
Please do not open issues not related to the website in this repository. If you have an issue with BTCPay Server software, open an issue in an appropriate repository.
All changes to the website should be applied in the src
folder.
The files in the src
are used in conjunction with the transifex/resources
to make the btcpayserver.org website.
Create pull requests affecting the CSS, JS, images etc in the src
-- and once merged, the changes will be used to roll out updates to the main directory.
Please do not submit any changes to the html files other than those within the src
directory.
To fix spelling or grammatical errors, make updates to either the English string(s) in the relevant file of the transifex/resources
directory or any of the non-english translations via the Transifex website. If you want to add new strings, append the .json
file, preserving the JSON format.
Modifying existing strings may cause the already-translated strings to be lost (more details).
Translations help us make the software relevant for people who need it around the world.
If you would like to help us translate btcpayserver.org, please join the team on Transifex.
Translations are only handled through Transifex, please do not create a pull request for translations.
For more information on contributing by translating, check the translation guides
Translators can opt-in to be notified when new strings require translating for a language they're subscribed to.
We used a 90% minimum threshold for translations.
Prerequisites:
- Node.js >= 10
- Create a
.env
file containing the API token for Transifex (TRANSIFEX_TOKEN="my_api_token"
)
Setup:
# Install the dependencies
npm install
# Download the translations – this is mandatory for the rest to work
npm run init
Build:
# Build the site locally and start dev server
npm start
# Build the site for production
npm run prod