diff --git a/README.md b/README.md
index 734320d..b282b1c 100644
--- a/README.md
+++ b/README.md
@@ -1,108 +1,125 @@
-# OrreryTimer 🕰️✨
+# Nexus Timer 🕰️✨
-OrreryTimer is a dynamic multi-player timer designed for games, workshops, or any activity where turns pass sequentially in a circular fashion. It provides a clear visual focus on the current participant, their immediate predecessor and successor, and the direction of play, ensuring everyone stays engaged and aware of the flow.
-
-
-*(Replace with an actual screenshot or GIF once available)*
+Nexus Timer is a dynamic multi-player timer designed for games, workshops, or any activity where turns pass sequentially in a circular fashion. It provides a clear visual focus on the current participant and their immediate successor, ensuring everyone stays engaged and aware of who is next. This document serves as a detailed specification for a Progressive Web App (PWA) prototype aimed at game enthusiasts.
## Core Concept
-Inspired by an orrery (a mechanical model of the solar system), OrreryTimer visualizes players in a circular sequence. The "Current Player" is centrally featured, with the "Previous Player" and "Next Player" flanking them, clearly indicating the flow of turns. This tool is perfect for board games, round-robin discussions, timed presentations, or any scenario needing structured turn management with individual countdowns.
+Nexus Timer visualizes players in a circular sequence. The **Current Player** is prominently displayed in the top half of the screen, and the **Next Player** is in the bottom half. This clear visual pairing indicates the flow of turns, making it perfect for board games, role-playing games, timed presentations, or any scenario needing structured turn management with individual countdowns.
-## Key Features ✨
+## Target Audience
+
+Game enthusiasts who play turn-based games (board games, tabletop RPGs, card games) and need a visually clear and customizable timer solution.
+
+## Tech Stack
+
+* **HTML5:** For structuring the user interface.
+* **CSS3:** For styling and visual presentation, including animations. Consider a CSS framework like Tailwind CSS for rapid prototyping.
+* **JavaScript:** For application logic, timer functionality, and event handling.
+* **Web Audio API:** For audio feedback (ticking sounds, alerts).
+* **Browser API:** For capturing Players' photo.
+* **Local Storage/IndexedDB:** For persistent storage of player data, timer states, and settings.
+* **Service Worker:** Essential for PWA functionality (offline access, push notifications - potential future feature).
+* **Manifest File:** Defines the PWA's metadata (name, icons, theme color).
+* **Web Framework:** Use Vue.js
+* **(Optional) Tailwind CSS:** Utility-first CSS framework for rapid UI development.
+
+## Hardware Recommendations (Optional Enhancement)
+
+For an enhanced tactile experience, Nexus Timer supports Smart Buttons based on Bluetooth-connected microcontroller (e.g., XIAO nRF52840) implementing HID (Human Interface Device) protocol.
+
+* **Buttons:** Connect 3 physical buttons, potentially extended (e.g., via 1.5m wires) for easy player access.
+* **Configuration:**
+ * **Player 1's Button:** Single Click: Emulates a key press (e.g., 'a'). Configure this as Player 1's "Pass Turn / My Pause" hotkey in the app.
+ * **Player 2's Button:** Single Click: Emulates a key press (e.g., 'b'). Configure as Player 2's "Pass Turn / My Pause" hotkey.
+ * **Player 3's Button:** Single Click: Emulates a key press (e.g., 'c'). Configure as Player 3's "Pass Turn / My Pause" hotkey. Long Press (if Player 3 is Game Admin): Emulates a key press (e.g., 's'). Configure as the "Global Stop/Pause All" hotkey in the app.
+
+## Key Features
* **Circular Player Display:**
- * Central focus on the **Current Player**.
- * Adjacent displays for **Previous** and **Next Players**.
- * Clear visual connection between these three roles.
- * Animated indicator showing the **direction of play** (clockwise/counter-clockwise).
+ 1. **Normal Mode (Default):** Central focus on the **Current Player** (top) and **Next Player** (bottom).
+ 2. **All Timers Running Mode:** List of players with running timers.
* **Individual Player Timers:**
- * Each player has a customizable countdown timer (MM:SS).
- * Timers continue into **negative time** if the limit is reached (up to -59:59).
- * Players whose timers reach max negative time are "skipped" but remain visually present.
- * Visual feedback: Red pulsating effect for active timers (background for positive, text for negative).
+ * Customizable countdown timer (MM:SS) for each player.
+ * Timers continue into **negative time** (e.g., -MM:SS) up to a limit (e.g., -59:59).
+ * Players reaching max negative time are **skipped** until reset or timer edit.
+ * Visual feedback: Pulsating effect for active timers (background for positive, text for negative). Skipped players are visually distinct (e.g., greyed out).
* **Two Game Modes:**
- 1. **Normal Mode (Single Active Timer):**
- * Only the Current Player's timer is active.
- * Pass turns via swipe gestures (left/right) or player-specific hotkeys.
- * Tap Current Player to pause/resume their timer.
+ 1. **Normal Mode (Default):**
+ * Only the **Current Player's** timer runs.
+ * Pass the turn via **Swipe Up** on the Next Player's area or the Current Player's "Pass Turn / My Pause" hotkey.
+ * 3-seconds ticking sound when the timer starts to alert players about the "Pass Turn".
+ * Tap Current Player's area or use "Global Stop/Pause All" hotkey to pause/resume their timer without passing the turn.
+ * To pass the turn: **Swipe Up** on the Next Player's area or have the Current Player press their "Pass Turn / My Pause" hotkey. The current timer pauses, the next player becomes Current, and their timer starts.
2. **All Timers Running Mode:**
- * All player timers start and run simultaneously.
- * Ideal for scenarios where everyone has a global time limit or races against each other.
- * Players can pause their *own* timer when they are current.
- * Global "Start All / Stop All" control.
- * App-wide visual (pulsating background) and audio (continuous ticking) cues when active.
+ * All active player timers run simultaneously.
+ * Enter by clicking "All Timers Mode" (starts all timers).
+ * Continuous ticking sound when active.
+ * Initially, all players are shown in a list with their photo, name and timer value.
+ * Tapping on a player in the list pauses its timer. Any player can use their "Pass Turn / My Pause" hotkey to pause their *own* timer.
+ * Only players with a running timer are shown in the list.
+ * If all players pause their timers, automatically reverts to Normal Mode.
+ * Main button: "Stop All Timers" (pauses all, returns to Normal Mode) or "Start All Timers" (resumes all in this mode). Can also be triggered by "Global Stop/Pause All" hotkey.
* **Player Management:**
- * Add, edit, and delete players (minimum 3, up to 10).
- * Upload player photos or use default avatars.
- * Set initial timer values per player.
- * Assign unique "Next Turn" hotkeys and non-unique "Stop My Timer" hotkeys.
- * Easily re-order players (drag-and-drop preferred).
+ * Add, edit, and delete players (2-7 players).
+ * Use device camera (access via browser API) or default avatars for the player's picture.
+ * Set initial timer values per player (Default: 60:00).
+ * Assign unique "Pass Turn / My Pause" hotkeys (single keypresses). E.g.: Use the Player's 1 "single click" action to insert the key.
+ * Assign the "Global Stop/Pause All" hotkey (single keypresses). E.g.: Use the Player's 3 "long press" action to insert the key.
+ * Re-order players (drag-and-drop planned), reverse, shuffle.
* **Intuitive Controls:**
- * Swipe gestures for changing Current Player and turn direction in Normal Mode.
- * Tap interactions for timer control.
- * Global hotkey for "Stop All Timers."
+ * **Swipe Up:** (On the Next Player's area). Primary gesture for passing turns (Normal Mode).
+ * **On-Screen Taps:** (On the Current Player's area). For pausing/resuming timers contextually.
* **Audio Feedback:**
- * Continuous ticking in "All Timers Running Mode."
- * 3-second alert tick when a timer becomes active in "Normal Mode."
- * Option to mute all sounds.
-* **Persistence:** Player configurations, current timer states, and game settings are saved locally, so your setup is ready when you reopen the app.
-* **Global Reset:** A "Reset Game" button to revert all timers to initial values and reset the game state.
+ * Continuous ticking in "All Timers Running Mode" when active.
+ * Brief 3-second tick when a timer starts in Normal Mode. Cancel the sound when the timer pauses.
+ * Global mute option.
+* **Visuals:**
+ * Designed for mobile phone screens (portrait orientation).
+ * Light/Dark theme options.
+* **Persistence:** Player setups, timer states, and settings are saved locally using browser Local Storage.
+* **Global Reset:** "Reset Game" button restores all timers to initial values and resets game state.
-## Tech Stack (Planned/Example)
+## UI/UX Considerations (For AI Generation)
-## Getting Started
+* **Minimalist Design:** Focus on clarity and ease of use. Avoid clutter.
+* **Large, Clear Timers:** Timers should be easily readable at a glance.
+* **Color Coding:** Use color to indicate timer state (e.g., green for running, red for negative time, grey for skipped).
+* **Responsive Layout:** The UI should adapt to different (mobile phone) screen sizes.
+* **Touch-Friendly:** Buttons and interactive elements should be large enough for easy tapping.
-**(Details to be added once development begins)**
+## Data Model (For AI Generation)
-1. **Prerequisites:**
- *
-2. **Installation:**
- ```bash
- git clone https://gitea.virtonline.eu/2HoursProject/OrreryTimer.git
- cd OrreryTimer
+```json
+{
+ "players": [
+ {
+ "id": "1",
+ "name": "Alice",
+ "avatar": "image",
+ "initialTimer": "60:00",
+ "currentTimer": "60:00",
+ "hotkey": "a",
+ "isSkipped": false
+ },
+ {
+ "id": "2",
+ "name": "Bob",
+ "avatar": "image",
+ "initialTimer": "60:00",
+ "currentTimer": "60:00",
+ "hotkey": "b",
+ "isSkipped": false
+ }
+ ],
+ "globalHotkey": "s",
+ "currentPlayerIndex": 0,
+ "gameMode": "normal", // "normal" or "allTimers"
+ "isMuted": false
+}
+```
+## Installation
+Build the app with docker
- ```
-3. **Running the Application:**
- ```bash
-
- ```
-
-## Usage Guide
-
-1. **Manage Players:**
- * Click "Manage Players."
- * Add at least 3 players. For each player:
- * Enter a name.
- * Optionally, upload a photo.
- * Set their initial timer duration.
- * Optionally, assign a "Next Turn" hotkey (must be unique) and a "Stop My Timer" hotkey.
- * Arrange players in the desired turn order.
- * Save changes.
-2. **Main Screen:**
- * The Current, Previous, and Next players will be displayed.
- * The turn direction indicator shows the flow.
-3. **Normal Mode (Default):**
- * Tap the Current Player's area to start/pause their timer.
- * Swipe left or right on the Current Player's area to pass the turn and set the direction. The new Current Player's timer will start/resume.
- * If the Current Player has a "Next Turn" hotkey, pressing it will pass the turn.
-4. **All Timers Running Mode:**
- * Click "Start All Timers." All player timers will begin counting down.
- * The app background will pulse red, and a ticking sound will play.
- * When it's a player's "focus" as Current Player, they can tap their area or use their "Stop My Timer" hotkey to pause their *own* timer. The focus will then shift to the next player with a running timer.
- * Click "Stop All Timers" (or use the global hotkey) to pause all running timers.
-5. **Reset Game:**
- * Click "Reset Game" and confirm to restore all timers to their initial values and reset player positions.
-
-## Configuration
-
-* **Player Hotkeys:** Configured in the "Add/Edit Player" form.
- * "Next Turn" Key: Advances to the next player in Normal Mode.
- * "Stop My Timer" Key: Pauses the current player's timer in All Timers Running Mode.
-* **Global "Stop All" Hotkey:** [Specify default, e.g., 'Escape' or 'S'] - this pauses all timers in any mode.
-* **Audio Mute:** Look for a settings icon or option to mute all sounds.
-
-## Future Enhancements 🚀
-
-* Light/Dark theme options.
-* Ability to save and load different game setups (player lists & timer configurations).
+```bash
+docker build -t nexus-timer .
+```
\ No newline at end of file
diff --git a/assets/default-avatar.svg b/assets/default-avatar.svg
new file mode 100644
index 0000000..e5c534b
--- /dev/null
+++ b/assets/default-avatar.svg
@@ -0,0 +1,4 @@
+
diff --git a/assets/favicon-16x16.png b/assets/favicon-16x16.png
new file mode 100644
index 0000000..8d52034
Binary files /dev/null and b/assets/favicon-16x16.png differ
diff --git a/assets/favicon-32x32.png b/assets/favicon-32x32.png
new file mode 100644
index 0000000..ec20525
Binary files /dev/null and b/assets/favicon-32x32.png differ
diff --git a/assets/icon-192x192.png b/assets/icon-192x192.png
new file mode 100644
index 0000000..7fabb38
Binary files /dev/null and b/assets/icon-192x192.png differ
diff --git a/assets/icon-512x512.png b/assets/icon-512x512.png
new file mode 100644
index 0000000..6c47bef
Binary files /dev/null and b/assets/icon-512x512.png differ
diff --git a/favicon.ico b/favicon.ico
new file mode 100644
index 0000000..d8045d9
Binary files /dev/null and b/favicon.ico differ
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..07d6020
--- /dev/null
+++ b/index.html
@@ -0,0 +1,86 @@
+
+
+