Skip to content

Commit

Permalink
docs: add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Tarow committed Dec 27, 2023
1 parent d1006d3 commit 4b2c2f4
Showing 1 changed file with 65 additions and 0 deletions.
65 changes: 65 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Skat-Counter - Web-App to track your Skat games

Skat-Counter is a simple Go application i started writing in order to learn about [htmx](https://htmx.org/), [templ](https://github.com/a-h/templ) and [jet](https://github.com/go-jet/jet). For the time being it is kind of experimental and a lot of things like proper error handling and logging are still missing.

Nevertheless it is in a working state and can be used for testing purposes.
For data storage, SQLite is being used.

## Features

- Create Skat-Games
- Creation time
- Did you play online (e.g. Tabletop Simulator) or in person?
- How high is the stake?
- Variable number of players
- Edit games
- Stake & online/in person indicator can be changed at any time
- Delete games
- Unwanted games can be deleted again
- Add/modify & delete rounds

The features and calculations are designed towards the way that my friends and i play Skat, depending on your rules, it might not be suitable for you.

## Installation

### Go Binary

```
go install github.com/tarow/skat-counter@latest
```

### Docker

```bash
docker run -v ./data:/app ghcr.io/tarow/skat-counter:latest
```

### Docker Compose

```yaml
version: "3.7"

services:
skat-counter:
image: ghcr.io/tarow/skat-counter:main
container_name: skat-counter
restart: unless-stopped
ports:
- "8080:8080"
volumes:
- ./data:/app
```
## Screenshots
### Game Overview
![](screenshots/game_overview.png)
### Game Details
![](screenshots/game_details.png)
### Create Game
![](screenshots/create_game.png)

0 comments on commit 4b2c2f4

Please sign in to comment.