Front	Back

Ever wanted to play with your own Shit Happens playing cards? Now you can. Write down the most miserable situations you can think of and rank them. This project automatically outputs playing cards in pdf format.

This project is not related to the original card game. Open an issue in case of any objections.

(back to top)

App

The tool is available as an online Streamlit Community Cloud app or via Docker

docker run -p 8501:8501 ghcr.io/siemdejong/ithappens

Development

Prerequisites

The dependencies are managed with uv. Otherwise, a virtual environment with python 3.9 or higher is required.

Installation

Developers should fork this repository and run

git clone https://github.com/<your-username>/ithappens.git

This will place the sources in a directory ithappens below your current working directory, set up the origin remote to point to your own fork, and set up the upstream remote to point to the ithappens main repository. Change into this directory before continuing:

cd ithappens

Create a dedicated environment

You should set up a dedicated environment to decouple your ithappens development from other Python and ithappens installations on your system. Run uv sync or pip install -e . to sync your python environment.

(back to top)

Contributing

Any contributions you make are greatly appreciated.

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)

Built With

(back to top)

License

Distributed under the GPL-3.0 license. See LICENSE for more information.

(back to top)