Merge pull request #338 from Dino-Kupinic/develop

Author: Dino-Kupinic

.github/assets/banner.png

@@ -3,30 +3,27 @@
 
 ### Features
 
-* add landing page video ([012b285](https://github.com/HTL-Steyr/tourney/commit/012b285584516772196408fd793bf9e8c2a3d3c1))
+- add landing page video ([012b285](https://github.com/HTL-Steyr/tourney/commit/012b285584516772196408fd793bf9e8c2a3d3c1))
 
 # [0.39.0](https://github.com/HTL-Steyr/tourney/compare/v0.38.0...v0.39.0) (2026-03-13)
 
-
 ### Features
 
-* improve AI ([6f49daf](https://github.com/HTL-Steyr/tourney/commit/6f49daf085016d0a482f5ce626a3fd89a4f26063))
-* improve live view ([277e15e](https://github.com/HTL-Steyr/tourney/commit/277e15ef43e43312f9a055ad10c001e5238addc7))
+- improve AI ([6f49daf](https://github.com/HTL-Steyr/tourney/commit/6f49daf085016d0a482f5ce626a3fd89a4f26063))
+- improve live view ([277e15e](https://github.com/HTL-Steyr/tourney/commit/277e15ef43e43312f9a055ad10c001e5238addc7))
 
 # [0.38.0](https://github.com/HTL-Steyr/tourney/compare/v0.37.2...v0.38.0) (2026-03-12)
 
-
 ### Features
 
-* reduce paper margins ([c04a90e](https://github.com/HTL-Steyr/tourney/commit/c04a90eaed3d58c0483d19b2fbf3bf788669b98c))
-* switch from puppeteer -> gotenberg ([2f46ca3](https://github.com/HTL-Steyr/tourney/commit/2f46ca3b857994c3d5fd4c508bb54bbb9f458165))
+- reduce paper margins ([c04a90e](https://github.com/HTL-Steyr/tourney/commit/c04a90eaed3d58c0483d19b2fbf3bf788669b98c))
+- switch from puppeteer -> gotenberg ([2f46ca3](https://github.com/HTL-Steyr/tourney/commit/2f46ca3b857994c3d5fd4c508bb54bbb9f458165))
 
 ## [0.37.2](https://github.com/HTL-Steyr/tourney/compare/v0.37.1...v0.37.2) (2026-03-11)
 
-
 ### Bug Fixes
 
-* nixpacks already install puppeteer pkgs ([899e3a3](https://github.com/HTL-Steyr/tourney/commit/899e3a3a0c35119084d2d08420dd1894b80d9cd2))
+- nixpacks already install puppeteer pkgs ([899e3a3](https://github.com/HTL-Steyr/tourney/commit/899e3a3a0c35119084d2d08420dd1894b80d9cd2))
 
 ## [0.37.1](https://github.com/HTL-Steyr/tourney/compare/v0.37.0...v0.37.1) (2026-03-11)
 

.github/assets/preview-banner.jpg

@@ -1,4 +1,4 @@
-![tourney](./.github/assets/banner.png)
+![tourney](./.github/assets/preview-banner.jpg)
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Version](https://img.shields.io/github/v/release/HTL-Steyr/tourney?color=blue)](https://github.com/HTL-Steyr/tourney/releases)
@@ -11,8 +11,19 @@
 
 Mono repository for the tourney project. This project is a web application for managing tournaments.
 
-It includes an admin dashboard for managing tournaments, teams/players, live scores, and a client app for tournament
-attendees.
+### ⚽️ Features
+
+- 🏆 tournament setup for football, volleyball, and basketball with rules, time windows, prizes, and automatic group assignment
+- 📡 live control for group stages, active matches, and score updates during the event
+- 🎓 class and school year management as the base for team and registration logic
+- 🎟️ central registration management with registration links, teams, and status handling
+- 📰 news and gallery management directly from the admin dashboard
+- 🌳 public tournament details, live brackets, standings, and media updates in the viewer
+- 🤖 AI assistant for tournament setup and management suggestions in the admin dashboard
+
+### Live Deployment
+
+> https://tourney.dino-kupinic.dev
 
 ## ⏳ Activity
 
@@ -40,25 +51,35 @@ git clone https://github.com/Dino-Kupinic/tourney.git
 ./scripts/setup.sh
 ```
 
+> [!WARNING]
+> The setup script is due to be changed.
+
 > [!NOTE]
 > Windows users need WSL installed.
 
 Requirements:
 
 - Docker
 - Bun
+- Node.js 22
 
 #### Manual Installation
 
 2. install packages
 
 ```bash
-bun i
+bun install
 ```
 
 > [!TIP]
 > If you don't have bun installed, checkout https://bun.sh to install for your operating system.
 
+3. optionally run all development servers
+
+```bash
+bun run dev
+```
+
 ### Backend
 
 1. run supabase
@@ -84,10 +105,11 @@ Create a `.env` file and checkout the `.env.example`.
 Copy the content into your `.env` and replace the following fields with your own.
 
 | Field                    | Description                                            |
-| ------------------------ | ------------------------------------------------------ |
+|--------------------------|--------------------------------------------------------|
 | `SUPABASE_URL`           | URL to Supabase API                                    |
 | `SUPABASE_KEY`           | Anon key                                               |
 | `SUPABASE_SECRET_KEY`    | Secret key (service-level key)                         |
+| `OPENAI_API_KEY`         | OpenAI API key for the admin AI assistant              |
 | `NUXT_PUBLIC_CLIENT_URL` | URL of the viewer app, default `http://localhost:3001` |
 
 2. run dev server
@@ -106,10 +128,13 @@ If it works, great!
 
 Create a `.env` file and checkout the `.env.example`. Copy the content into your `.env` and replace the following fields
 
-| Field          | Description         |
-| -------------- | ------------------- |
-| `SUPABASE_URL` | URL to Supabase API |
-| `SUPABASE_KEY` | Anon key            |
+| Field                     | Description                  |
+|---------------------------|------------------------------|
+| `SUPABASE_URL`            | URL to Supabase API          |
+| `SUPABASE_KEY`            | Anon key                     |
+| `NUXT_GOTENBERG_URL`      | URL to the Gotenberg service |
+| `NUXT_GOTENBERG_USERNAME` | Gotenberg username           |
+| `NUXT_GOTENBERG_PASSWORD` | Gotenberg password           |
 
 2. run dev server
 
@@ -121,14 +146,38 @@ bun run dev:viewer
 
 If it works, great!
 
+#### Landing page (www)
+
+1. define environment variables
+
+Create a `.env` file and checkout the `.env.example`. Copy the content into your `.env` and replace the following fields
+
+| Field                              | Description           |
+|------------------------------------|-----------------------|
+| `SUPABASE_URL`                     | URL to Supabase API   |
+| `SUPABASE_KEY`                     | Anon key              |
+| `NUXT_PUBLIC_ADMIN_APP_URL`        | URL of the admin app  |
+| `NUXT_PUBLIC_VIEWER_APP_URL`       | URL of the viewer app |
+| `NUXT_PUBLIC_MUX_DEMO_PLAYBACK_ID` | URL of mux asset id   |                       |
+
+2. run dev server
+
+```bash
+bun run dev:www
+```
+
+3. Head to http://localhost:3002/
+
+If it works, great!
+
 #### User creator script
 
 1. define environment variables
 
 Create a `.env` file and checkout the `.env.example`. Copy the content into your `.env` and replace the following fields
 
 | Field                 | Description                    |
-| --------------------- | ------------------------------ |
+|-----------------------|--------------------------------|
 | `SUPABASE_URL`        | URL to Supabase API            |
 | `SUPABASE_SECRET_KEY` | Secret key (service-level key) |
 | `USERS_TO_CREATE`     | See comment in `.env.example`  |
@@ -147,15 +196,15 @@ If it works, great! You can now log in in the admin dashboard with the created u
 
 - [@Dino Kupinic](https://www.github.com/Dino-Kupinic)
 
-### Core Maintainer
-
-- [@Leon Arbeithuber](https://github.com/larbeith)
-
 ## 🛠️ Tech Stack
 
+- Bun
+- Turbo
 - Nuxt 4
 - Supabase
 - Docker
+- OpenAI API
+- Gotenberg
 
 ## Contributing
 

CHANGELOG.md

@@ -2,3 +2,4 @@ SUPABASE_URL=""
 SUPABASE_KEY=""
 NUXT_PUBLIC_ADMIN_APP_URL=""
 NUXT_PUBLIC_VIEWER_APP_URL=""
+NUXT_PUBLIC_MUX_DEMO_PLAYBACK_ID=""