Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/emoral435/swole-goal

Size is the prize - and swole is the goal πŸ‹οΈ
https://github.com/emoral435/swole-goal

api-rest docker-compose go postgresql sveltejs

Last synced: about 1 month ago
JSON representation

Size is the prize - and swole is the goal πŸ‹οΈ

Awesome Lists containing this project

README

        

[//]: # "header"

πŸ‹οΈβ€β™‚οΈSwole is the GoalπŸ‹οΈβ€β™‚οΈ

[//]: # "tech stack used"


Postgres
Go
TypeScript
GitHub Actions
Svelte

[//]: # "catch"


A web-based, open-source alternative to track your lifts πŸ‹οΈ

## Why was this made? πŸ€”πŸ’­
* Created as a solution to opting out of continuing to buy [Strong's subcription](https://www.strong.app/) to track my weightlifting journey
* During my time at University learning relational databases, I realized that the underlying technology to store and track progression within the gym was something that I would love to challenge myself with!
* An open-source solution to save money and customize to a communities liking πŸ€©πŸ’«

## Screenshots of the application! πŸ˜²πŸš€

## How do I run this locally? πŸ’šπŸ™‚
> [!NOTE]\
> This program is fully hosted right now via localhost and package by a Docker container. I would love to host this on AWS, but I do not have the funds to manage their RDS instance :()
>
> Click -> [here](https://docs.docker.com/desktop/install/windows-install/) to go to the installation page.

With Docker Desktop installed and opened, you can run these commands at the root directory of this GitHub repo...
```shell
# if you are running this for the first time, or have made changes and want to see it take affect on its deployment, use this
docker compose up -d --build
# starts the application in its detached state
docker compose up -d
# turns off the application
docker compose down
# wipes the container clean, effectively deleting the volumes for the database
docker compose down -v
```
And then open up [localhost:4173](localhost:4173) πŸ’š

## The Wiki πŸ“•
Visit the [wiki](https://github.com/emoral435/swole-goal/wiki) in order to see more documentation about...
* How to use the software
* The database, and its general initial schema
* Contribution Guidelines
* Go's API documentation
* Dev dependencies for local development
* Local / Cloud usage
And more!

## Get in touch πŸ’¬
If you liked what you saw, feel free to contact me! email: [email protected]

[Star Logs πŸš€](https://starlogs.dev/emoral435/swole-goal)