ceruleanskis / 531Calculator

A calculator app for 5/3/1 workouts.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Issues GPL Version


Logo

531 Calculator

A calculator app for 5/3/1 workouts.

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Testing
  5. Roadmap
  6. Contributing
  7. License
  8. Acknowledgments

About The Project

Product Name Screen Shot

This app serves as a tool to quickly calculate percentages and warmups for your 5/3/1 workout, based off of your training max.

(back to top)

Built With

(back to top)

Getting Started

To get a local copy up and running follow these steps.

Prerequisites

Installation

  1. Clone the repo:
    git clone https://github.com/ceruleanskis/531Calculator.git
  2. Navigate to the ui directory and install the NPM packages:
    npm install
    • Or, if using Yarn:
      yarn install
  3. Navigate to the server directory and install the Python packages:
    python -m venv venv
    source venv/bin/activate
    pip install -e .

(back to top)

Usage

Running a local development server

  1. Navigate to the ui directory.
  2. Serve the React app:
    yarn start
  3. Navigate to the server directory.
  4. Serve the Flask app:
    FLASK_APP=fivethreeonecalc FLASK_ENV=development flask run
  5. You should see the app at http://localhost:3000.

Running a local dev server via docker-compose

docker-compose -f docker-compose.dev.yml up You should see the app at http://localhost:8080.

(back to top)

Testing

To run the frontend tests:

Navigate to the ui directory and run:

yarn run test

To run the backend tests:

Navigate to the server directory and run:

pytest

Roadmap

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GPL 3 License. See LICENSE.txt for more information.

(back to top)

Acknowledgments

(back to top)

About

A calculator app for 5/3/1 workouts.

License:GNU General Public License v3.0


Languages

Language:TypeScript 65.9%Language:Python 24.7%Language:JavaScript 3.2%Language:SCSS 3.1%Language:Dockerfile 1.3%Language:HTML 1.0%Language:CSS 0.7%Language:Shell 0.0%