Skip to content

bandinopla/weightxreps-client

Repository files navigation

Logo

Welcome

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.

✨ The Client

This is the code for the front-end 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.

This is a React App that was created with Create React App and it uses Apollo Client to comunicate with the server vía GraphQL using Hooks created with a GraphQL Code Generator by the backend side during development.

If you are developing both backend and front end, clone both repos into a folder and name each folder client and server. This is required because the sever generates code 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


☕ Run local dev client

To run this if you have the dev server also running in your machine ( at localhost:4000/graphql), run:

npm run start

If you don't have a local database and want to use the real data from the site, run:

npm run start:production

⚠️ NOTE: This will we the same as visiting the site weightxreps.net the data will be all real because the client will point to the production graphql endpoint.


👀 Some key stuff to know...

Some things you need to know to save you some time from understanding the source:

  • src\data\db.js creation of the ApolloClient and endpoints.
  • src\codemirror\LogTextEditor.js the Workout Editor (uses a custom Code Mirror mode)
  • src\componentes\journal\editor.js React Component for the Editor
  • src\componentes\journal\jparser.js Text parser to understandable tokens.
  • src\data\Menu.js the data from the main menu of the site.
  • src\session code related to handling of the user session.
  • src\componentes\calendario.js code for the calendar widget
  • src\componentes\weight-value.js widget in charge of showing a weight unit and changed it depending on the user preference setting.

🏆 How to contribute?

If you would like to contribute, follow these steps:

  1. Fork the weightxreps-client repository.
  2. Create a new branch in your fork to make your changes.
  3. Commit your changes to your new branch.
  4. Push your changes to your fork on GitHub.
  5. Submit a pull request from your branch to the weightxreps-client repository.

I will review your pull request and, if everything looks good, merge it into the main codebase.

Questions?

If you have any questions about contributing, feel free to open an issue in the weightxreps-client repository and ask.


♥️ Support / Donate

If you have a weightxreps.net account log in and go to the donations page

If you want to donate directly, my paypal is pablo@weightxreps.net ..