I am thrilled to announce that I am releasing my backend code and frontend code to the community as open source. This has been a long-time goal of mine and I am excited to see the impact it will have.
By making the code available to all, I am hoping to attract contributions from other developers that can help enhance the codebase. This will result in a stronger and more reliable code, as well as promote collaboration and creativity within the community.
I believe that this open source release will be a great step forward for the project and I can't wait to see what the community will create with it.
This is the code for the server side of http://weightxreps.net
Weight For Reps is a training journal logging tool to help you keep track of your weight training. Mostly orientated towards Powerlifting/Weightlifting style of training.
The server runs in NodeJS as a GraphQL server but it is wrapped with Express so the potential to use it for other things is there but currently not used.
The Front-End comunicates with this server vรญa GraphQL calls to http://weightxreps.net/wxr-server-2/graphql
using Apollo GraphQL ( both client and server )
The serves uses a MySQL database. To setup a development database on your machine use docker-compose. The docker compose related files are in wxr-dev-db
folder. Note: it will be empty...
cd wxr-dev-db
docker-compose up
To fill this new "empty" database with dummy data, run this command:
npm run reset-db
Everytime you run that script, the database will be truncated, all data will be deleted and new dummy data will be created.
The database connection settings live in the .env
file. Make sure they match your dev database settings. Read the docker-compose.yml
to see which username, password and database name are used in dev mode...
To start playing with the code you will need NodeJS and keep in mind that the server in which the site is currently hosted works with Node Version 14.20.1 so if you plan to add some new feature make sure it is in range on the features provided up to that point or else the code wont run.
in VS Code you can go to "Run > run Dev" or "Run > Production" it will only serve to set the NODE_ENV environment variable to development or production
or vรญa NPM ( you will need to install NodeMon )
npm run dev
The code will load the .env
file to configure itself.
The code lives in the ./server
folder. The code that handles the GraphQL shema is is ./server/db/resolvers
If you are developing both backend and front end, clone both repos into a folder and name each folder
client
andserver
. This is required because the sever generates code when you make changes in the graphql schema and runnpm run exportschema
and goes one level up and expect a client folder to exist... these files will be dynamically created: -generated---db-introspection.json
-generated---db-types-and-hooks.tsx
firebase-adminsdk-credentials.js
you will need to create & place this file inside ofserver
with a firebase account..env
place this at the root of this proyect. This file should contain the info to connect to the database in your dev environment. Use.env.example
as base.
This is the data used in the SBD World Rank setion of the site.
To update the SBD rank data run npm run update-sbd-rank
that will download the latest ZIP from openpowerlifting, process it and store the resulting data in server/db/resolvers/sbd-stats.js
after that is done, that's all there is to it... the server should be re-run and the new data will be used.
Note: it will take a while to process...
They are hard-coded in server/utils/ename2type.js
These are the exercises that the site "understands" and adds them to the community stats.
If you would like to contribute, follow these steps:
- Fork the
weightxreps-server
repository. - Create a new branch in your fork to make your changes.
- Commit your changes to your new branch.
- Push your changes to your fork on GitHub.
- Submit a pull request from your branch to the
weightxreps-server
repository.
I will review your pull request and, if everything looks good, merge it into the main codebase.
If you have any questions about contributing, feel free to open an issue in the weightxreps-server
repository and ask.
If you have a weightxreps.net account log in and go to the donations page
If you want to donate directly, my paypal is [email protected]